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ABSTRACT 

Too often computer applications try to supplant 
rather than augment human capabilities. As a result, there is a gap 
between the power of the computer and some difficult administrative 
problems; e.g., longrange planning. However, there is increasing 
interest in the use of computer simulation in planning. PLANTRAN II 
represents a completely new approach away from former attempts to 
develop computer planning techniques. Hith this system, the 
decisionmakers can play an active role in the development of models 
with reduced dependence on technical staff. PLANTRAN II, which 
requires no technical expertise from the user, uses a simple language 
that is almost the same as the clerical instructions used in manual 
methods. This simple language is presented to a computer compiler 
that translates the instructions into computer terms. The 
instructions are processed by the computer, and the results are 
presented in a format set by the user. This manual contains 
information not only on the uses of the system but also on planning 
in general. It has a programed instruction set on the PLANTRAN II 
language. (Parts of pages 4*7 may reproduce poorly.) (Author/NH) 
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PREFACE 



American technology thrives on the solution of physical problems. 
We can mass produce "individualized" products. We can send men a quarter of 
a million miles through space and land them within several hundred yards of 
a pinpoint target. However, we are not able to cope as well with problems 
that hav? significant human elements. 

The electronic computer is one of the tools produced by our tech- 
nology. Unfortunately the hopes for a computer-led revolution in management 
have turned to disillusionment. 

This disillus^xinment (foes not result from an inherent defect of 
the computer. It comes from the lack of humanly designed systems to simul- 
taneously oxploit the power of the computer and the judgment of the execu- 
tive. Too often computer applications try to supplant rather than augment 
human capabilities. As a result there is a gap between the power of the 
computer and some very difficult administrative problems. Long range 
planning is one example. 

There is increasing interest in the use of computer simulation in 
planning. Early attempts to develop computer planning techniques were 
validly criticized. Some techniques were so simple as to be trivial; others 
were so complex as to be impractical. 

PLAWTEIAN II is a completely new approach. With this system the 
decision makers can play an active role in the development of models. It 
reduces their dependence upon a technical staff. 

PLANTRAN II requires no technical expertise from the user. It 
uses a simple language that is almost the same as the clerical instructions 
used in manual methods. This simple language is presented to a computer 
compiler which translates the instructions into computer terms. The in- 
structions are processed by the computer and the results presented in a 
format set by the user. PLAMRAN II never requires the planner^ to know or 
understand any of the technical aspects of the machine. 

This manual contains information not only on the uses of the system 
but also on planning in general. It has a programmed instruction set on the 
PLANTEIAN II language. A person will understand the fundamentals of planning 
and be able to use the system after a few hours of studying this manual. 
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The PLAMIRAN II system and this manual were developed by the 
Economics and Management Science Division of Midwest Research Institute 
under the general supervision of Richard L. Salmon, Manager of Operations 
Analysis. Duane Dieckman, Dan Epp, James Miller, and William Pickett made 
major contributions. 

PLANTRAN II is a propi 'etary development of Midwest Research 
Institute which also maintains copyrights on the material in this manual. 
No part of this manual may be reproduced in any form without the express 
written permission of Midwest Research Institute. 
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CHAPTER 1 



PLANKING 

I. The Case for Long Range Planning 

Planning provides a systematic means for a college or educational 
system to develop a coiJrse of action to meet short range and intermediate 
goals and needs as veil as long range ones. In addition, the short range 
needs — the problems at hand — can be satisfied vithin the framework of the 
long range objectives of the organization. An organization that has care- 
fully developed plans is in a position to anticipate and react positively 
to external events rather than be controlled by them. Finally, proper 
planning can give an organization a realistic understanding of its capa- 
bilities and resources and permit the organization to experiment with 
alternatives open to it to determine what can and must be done. 



II. The Planning^ Process 

To be effective, planning must be approached in a systematic way. 
Effective planning demands a structured context for developing alternatives 
within a framework appropriate for policy and decision making. Figure 1-1 
is a presentation of such a planning approach. The approach consists of 
six basic steps, reinforced by analysis and review. 

The first and fundamental consideration is a careful examination 
of the philosophy of the organization--the why, the raison d'etre , the 
mission. All decisions, plans, and acts must be consistent with the organi- 
zational philosophy. 

Objectives are the second consideration and describe where the 
organization is now and where it desires to be at various points in the 
future. Consideration of objectives also aids in establishing priorities — 
deciding what is of itrmiediate concern and what may be deferred. 

Progratnn , the next consideration, are the logical product of 
the establishment of objectives. Programs are .actions, tasks and schedules 
required to achieve the objectives, and the planners must determine the 
scope and design of programs. 
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The fourth ?9?-?^^^^^'*^i95L--resources--brings reality into the 
planning process. Resources of personnel^ facilities, funds, and time 
must be examined and matched with yhat is needed for the programs. The 
natural outcome of this matching will often be changes in the programs 
arid, quite possibly, in the objectives. These changes may require that 
priorities be altered and that programs be modified. 

The fifth consideration--implementation--concerns execution of 
the plan. Responsibilities are assigned and resources are provided for 
incorporating the plan into the organization. The plan is analyzed and 
results are continually examined so that changes can be made to enhance 
the actual operation of the plan. The final consideration--results-- 
requires delineation of accomplishments under the plan. Measurement of 
the results permits the planner to observe what works and--more important — 
what does not work. 

The final analysis of the overall plan is converted into changes 
that feedback into the planning approach, giving future phases of the 
plan a higher probability of success. This feedback process of continuous 
examination and evaluation enhances the achievement of objectives. 

With the development of the electronic computer, a new technique, 
simulation, has evolved as a practical aid to planning. This technique 
employs logic and mathematics in the construction of a simulation model 
thao represents an organization's functions. The simulation model will 
portray real or expected conditions in organizational operations. The 
representation will be bksed upon t*ae planner's experience and observation 
of how the organization fimctions through time, and will be constructed by 
assigning quantitative values and relationships to the elements, or planning 
items, that characterize the organization. 

Simulation is basically a technique for conducting experiments. 
It can be used to study problems where rules, policies, procedures, and 
other controlling aspects are under question and in which the mimber of 
variables and the uncertain nature of input make the problem difficult 
to analyze by conventional -hniques . The products of simulation models 
are solutions to problems. These experiments at problem solving provide 
a method of determining cause-and-ef f ect relationships without actually 
committing resources. 

A simulation model that accurately reflects the complex and 
dynamic interrelationships of organization elements has several sub- 
stantial advantages: 



. Allows the consideration of more variables in the 
planning process; 

. Considers the effect of interrelated variables; 

. Permits experimentation vith a vide variety of operating 
alternatives; ? 

. Provides a communication link throughout the university 
by presenting a physical frame of reference; 

. Enables an administrator to assess the long term impact 
of short term decisions; 

Helps define the need for information. 

The following example illustrates the kind of situation in vhich 
computer simulation can be extremely helpful in quantifying and projecting 
the effects of change. In this example, the basic question that a simu- 
lation model can be used to solve is: "What will be the impact on student 
financial aid needs if a university increases its fees?" 

A university has forecast a need to increase its fees over the 
next five years. This increase, of course, will provide more income, 
but it will also affect other parts of the operation--particularly stu- 
dent financial aid. Additional funds will be needed simply to enable the 
students who are now receiving aid to meet the increased fees. 

At present 20 percent of the students receive some form of 
financial aid. As the tuition increases, however, a greater proportion 
of students will be unable to pay the fees in full, so that a greater per- 
centage of students will need financial aid. Not only will the amount of 
aid for each student increase; the number of students needing aid will 
also increase. One result is that additional funds will have to be ob- 
tained from federal and other sources. Another result may be that the 
size and the structure of the student financial aid office will have to 
be changed. For instance, if the percentage of students needing aid in- 
creases from 20 percent to 25 percent, more personnel may be needed to 
administer the student aid program. For the student aid office the per- 
centage increase in total number of students needing aid is not 5 percent 
but 25 percent. If additional personnel are needed, they may need more 
office space, and the financial aid operation itself will require additional 
funds for salaries, equipment, and expenseig. 
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This simplified example shows hov easily one apparently straight 
forward decision can quickly lead to a variety of other changes. s 
in these kinds of rapidly pyramiding, cause-and-ef feet events that a com- 
puter simulation model can be most helpful. If appropriate information 
and data have been incorporated into the model (such as percentage f 
students needing aid, average amount of aid given, number of stud'irLs 
served per professional employee), the computer can combine these .'igures 
with projected enrollment, future fees, and other relevant facto\-f and 
calculate the additional aid money and operating expenses at various point 
in the future. The computer will also incorporate these figures into the 
more general areas of the model, such as total income and tota.\ salary 
expense # 

' Such a computel* simulation model can free administrators and 
planners from innumerable time consuming and tedious calculaxlonp co 
determine the effects of various changes. In addition, the cc.aputer can 
effortlessly and accurately combine the thousands of bits data that one 
change is likely to affect and produce an overall pic'^'ure. 

The elements vof a simulation model tr address this problem are 
shovm in Figure 1-2. The operating budget, a conventional mathematical 
model, is the basis for the model structure. The model uses some of the 
budget line items and adds other items — number of students, number of 
faculty, etc. When the various elements of this model are projected into 
future years, the model simulates organizational behs. lor. 

III. A Flexible Approach to Modeling; and Simula " 

The conventional approach to tnoO'' design for institutional 
planning has been to look at the curr^^nt ;^-oblem situation, anticipate 
possible future problem situations, w^^ucify the factors that axe important 
to these situations and build a ^.odel around these factors and their 
Interrelationships . 

There > re two problems inherent in this approach. In order to 
idiqmtely v<i..rc:i>s future problem situations--the precise characteristics 
Ol wbif'. cannot be accurately known in advance — a large number of factors 
:ind relationships must be built into the model. The dilemma is that with 
too many factors extraneous to a specific problem situation, the model be- 
comes complex, confusing and thus of limited value. With few factors-- 
thus simple and straightforward— it becomes so narrow and simplistic that 
it has no value except for very special cases. The second problem is that 
regardless of how many factors have been included in a planning model — a 
situation will soon arise for which the model is not appropriate. 
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INSTITUTIONAL MODEL BASED ON BUDGET STRUCTURE 
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For example, budgets are almost universally built from the 
bottom up. A planning model designed to produce alternative 
annual budgets probably vould be structured the same vay. Hovever, a 
question often arises, "Suppose ve vere given a fixed amount for the total 
budget — what are the various alternatives for allocating this fixed budget 
and vhat consequences flov from each of these alternatives?" 

This is a valid question for a policy maker to ask, yet it vould 
be very difficult to ansver vith the "bottom-up" budget model. The model 
would have to be reprograramed. This leads to several further arguments 
against the fixed, monolithic planning model. These arguments involve 
cost, communication and currency. 

A. Cost 

A comprehensive and useful planning model designed and programmed 
for a specific institution to meet its unique planning needs will involve 
6-30 man-months of system analyst and programmer time. Staff turnover as 
well as the necessity to keep up with routine, day-to-day problems will 
further complicate matters. 

B. Communication 

The commimication that will be required between the administrators 
and the executives on the one hand and the systems analysts and programmers 
on the other will be quite extensive. The only alternative will be to 
incur the major risk of producing a planning system out of tune with 
institutional needs. The question naturally arises at this point — "is 
it easier to teach programmers how to plan or planners how to program?" 

C. Currency 

Once an acceptable model is designed and programmed, how long 
will it remain current? As indicated above, probably not very long. What 
then will be necessary to change it to better fit the current situation, 
the current planning issue? It will probably require reprogramming. The 
reprogramming effort required might 'range from minimal to massive. Will 
the original programmer be available for this effort? Will anybody be 
readily available? 

Thus , there is a case for the flexible approach that relieves 
the planners and decision makers from dependency on the systems and pro- 
gramming staff and that can place computing power in their hands without 
requiring extensive computer expertise. This was the approach taJcen in 
the development of the PLANTRAN II System. 
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IV. SiJinmary 

This PLMTRM System has been used by dozens of institutions and 
has proved itself to be a valuable aid in planning and analysis. This 
collective experience has underscored the following advantages: 

— Facilitates the involvement of top level administrators which 
is essential to. successful planning; 

— Reduces the expense of planning by eliminating the costly 
programming and systems analysis work; 

I 

— Focuses attention on the critical data needs so that priorities 
can be established for institutional research; 

— Begins where the organization is rather than requiring massive 
changes in the organization to accommodate a specific model or system; 

— Permits the involvement of students and faculty in the 
evaluation of plans; 

— Utilizes existing information- systems; 

— Provides usable results almost immediately; 

— Allows rapid and easy modification of model structure, planning 
item specification, and report format; 

— Allows the planner to grow toward more complicated and sophis- 
ticated methods of planning; 

\ — Emphasizes what the planner knows about planning — not what he 

knows about computers. 
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CHAPTER 2 



THE MODELING LANGUAGE 

f 

f 

The heart of the PLMTRAN System is the modeling language. 
Projections and interrelationships of planning items are handled by this 
simple planning language. The language uses a small vocabulary, based 
largely on standard English. The language, called PLANTRM II, is de- 
rived from PMNning TRANslator and is composed of model specification 
instructions. The key words of these instructions are illustrated in 
Table 2-1. 

In our discussion we use the term "planning item." A planning 
item is one component of a model, and it is used to describe a particular 
planning element and the values associated with that planning element for 
each period '^f a six or twelve period planning horizon. Thus the term 
planning item is used to designate all the constituents of one planning 
element. It is important to note that there are no fixed planning items 
in the system. We use the term "planning period " rather than year because 
the planning horizon may be in terms of years, months, quarters or' other 
useful time periods. 

Planning items which are independent, i.e. that can bt developed 
without involving other planning items, on one model might be dependent, 
i.e. involving other planning items, in another model. All planning items 
are specified by the planner, using the model specifications contained 
within the PLANTRAN II language. 

I. The Planning Matrix 

It may be usefvil to think of the planning system as a matrix 
(see Figure 2-2). Each row of the matrix represents the projection of a 
planning item over a 6 or 12 period planning horizon. These projections 
may be extensions of the current " value of a planning item, such as current 
AVERAGE SALARY projected with a 5 percent increase per period. For 
example, TOTAL SALARY EXEENSE is projected by taking the period-by-period, 
or column, values of AVERAGE SALARY and multiplying them the by the period- 
by-period values of TOTAL STAFF. This dependent relationship; of course, 
enables the projections of both AVERAGE SALARY and TOTAL STAFF to have been 
projected in whatever manner the planner may have specified. 
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TABLE 2-1 

KEYWORDS— MODEL SPECIFICATIONS 



PERCENT SUM PROJECT 

INCREASE SHIFT ACCUMULATIVE SUM 

DECREASE EQUATION ACCUMULATIVE PRODUCT 

GOAL MAXIMUM AVERAGE 

DATA MINIMUM ' RETURN ON INVESTMENT 

FILL 



KEYWORDS—OUTPUT SPECIFICATIONS 
PUNCH 
PLOT 
HEADING 
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It is the process of specif ying- each of these planning items 
and determining Too\^ they are to be projected and how they are related to 
other planning items that constitutes model building- The ease and sim- 
plicity of specifying each of the planning items belies the complexity 
that the completed model may represent- The relatively simple static 
model becomes dynamic through changes in planning items values and rela- 
tionships over time. 

II. Types of Model Specification 

The PLMTRM II language includes three general methods of model 
specification: independent methods of projection,, dependent methods of 
projection^ and headings or section titles. • The planner uses these methods 
in a variety of ways ,to build a model of any desired complexity. 

A. Independent Methods of Projection 

There are four ways to specify independently projected planning 
items. These four methods are compatible with manual planning techniques. 

1. Change by a percentage 

A planning item base level value may be changed (increased or 
decreased) by a specified percentage. This method generates a compound 
percentage increase or decrease for each planning period. 



CHANGE BY A PERCENTAGE 




2. Change by an incrernent 



A planning item base level value may be changed (increased or 
decreased) by a specified amount. This method geherates an incremental 
value increase or decrease for each planning period* 



CHANGE BY AN INCREMENT 




3- Change to achieve a ^oal 

A planning item base level value may be changed (increased or 
decreased) to a specified goal value in a specified number of planning 
periods. The goal value^ once achi* ;ed^ is maintained for the remaining 
periods in the planning horizon. 



CHANGE TO ACHIEVE A GOAL 




i ' 1 I 1 i 1 



Base 1 
Level 



2 3 4 5 



6 7 
Periods 



8 9 10 11 12 
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4. User supplied data 



The planning item values for the planning horizon may be inserted 
by the planner for any or all of the 12 planning periods. * 

us'lr supplied data 




Level 

Periods 



B. Dependent Methods of Projection 

The dependent methods are the most powerful means of model 
specification. They are used to interrelate planning items in almost un- 
limited combinations. 

1. Summation of other y planning items 

A planning item may be the summation of up to 15 other planning 

items. 



SUMMATION OF OTHER PLANNING ITEMS 





Planning Item D 




Planning Item D is the sum of 
Planning Items A, B, and C 








'*"""•"""*"*""""" * Planning Item C 

r t 1 1 1 1 1 1 i 1 


1 1 



Base 1 2 3 4 5 6 7 8 9 10 11 12 
Level _ . . 



2- Sh.if-b, or shlf-bed funcbion of ano-faher planning j-bepi 

A planning i-bem's values may be a function of ano-bher planning 
i-bem's values -that: .Viave been shifted forvard of backward a specified num- 
ber of periods « 

SHIFTED FUNCTION OF ANOTHER PLANNING ITEM 




Planning Ifem B is 80% of 
Planning !fem A, 'previous period 



Bose 
Level 



6 

Periods 



3- Function of o-falfier planning i'bems ' 

A planning i-bem may be derived from a planner- specified eq^ua-bion . 
An eq^ua1:ion may contain up -bo foior other planning items, multiplied by 
optional constant values, in combinations of addition, subtraction, multi- 
plication, dxvision, and exponentiation-" Parenthetical expressions a^e 
permitted. 



FUNCTION OF OTHER PLANNING ITEMS 




Planncng I fern C is a Function 
of Planning It-ems A and B 



Planning Item A 



J I I !_ 



Planning \ tern B 
J 1 _1 



J 1_ 
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Base 1 
Level 



5.6 7 
Periods 

a-7 



10 n 12 



^- Maximum (or minimum) of other planning items 

A planning item may iDe the maximum or minimum of up to four 
other planning items and a planner-specified constant^ period by period, 
across the planning horizon- 



MAXIMUM (MINIMUM) OF OTHER PLANNING ITEMS 



Planning Item D !s the maximum 
of Planning Ifems A, B, and C 




- «n ^ — 



Planning Ifem C 



Base 
Level 



6 

Periods 



5. Fill ajaot her plajining item 

A planning item may be the completed series which resi^ats from 
filling missing data in another planning item- The mis&ir^g data is esti- 
mated hy a modified linear regression technique - 



FILL ANOTHER PLANKr^.v^u^ ITEM 
(Estimated by a modi R»d (^'v^t.r.^T' rrigref 5 an technique) 



• Original period values 
X Computed semi-averages 
® Filled period volues 
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60 Pro^lecb ano-bher planning: 11:6111 . 

The planning item may be -the projection of anotlier planning Item. 
A trend associated with the planning item is developed and extrapolated 
Tor the next twelve periods. 



PROJECT ANOTHER PLANNING ITEM 




• Original period values 

X Compufed semT-averages 

® Filled period values 

ffl Projected period values 



Base 
Level 



10 11 12 



7 . Accumulative sum of another planning item 

A planning item may "be the accumulative sum of the period values 
of another planning item. 



ACCUMULATIVE SUM OF ANOTHER PLANNING ITEM 



Plonmng Item B ^^^^ Planning Item B is the accumufative 
sum af Planning Item A 



Plonning Item A ^ — — ——^ m 



Base 1 
Level 



2 3 4 5 6 7 

Periods 



10 11 ! 2 
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8i Accumula-blve produc-fa of ano-faher -planning item 

A planning i-bein may "be "the accumuXa-bive product: of -the period 
values ot ano-bher planning item. 

ACCUMULATIVE PRODUCT OF ANOTHER PLANNING ITEM 




9* Pun cla cards of other planning items 

A planning item may be reproduced as six puncHed cards in th.e 
format user supplied input . ^ - 
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10, Average of ano-ther planning it: em 



A planning i-bem may be -the moving average of ano-bher plajaning 
i-bem^ compu-bed period "by period across -the planning horizon. 



AVERAGE OF ANOTHER PLANNING ITEM 



Plonnmg Item A 



planning Ifem B 



Plonning ifem B is the moving overage 
of Plonning Item A 



5ose 1 
Level 



5 6 7 

Perrods 



10 n 12 
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11 . Prin'faer plcfa of o-bher planning i-bems " 

Up "bo four planning i-bems may be included in a .print: er plo-b , 
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X2. Re-bioj:*!! on Inves-bmen-b 



A planning i-tem may te -the percen-bage re-turn on inves-bment: which 
would resul-t from a cash flow represen-bed in ano-bher planning i-bem. 



RETURN ON INVESTMENT OF ANOTHER PLANNING ITEM 



X Investment 

• Cash Flow Values 



Cash flow values, converted to 
present value at period one by 
rate of return which permFts 
values to sum to equal investment 



Base 
Level 



5 6 7 

Periods 



C Headings, or Section Ti^bles 



A planning' i-bem may be a heading , or seq-bion -bi-ble^ specified hy 
-bhe planner -bo separa-be planning i-bems in -bhe planning ma-brix. 



III. Model Developmen-b 

Up "bo -bhis poin-b we have described -bhe various me-bhods hy which" 
-bhe planner can specify individual planning i-bems in -bhe PLAWTRADT II 
langua.ge . Model, building is -bhe applica-bion of these me-bhods -bo -bhe da-ba 
of aA organizai-tion. In developing -bhe models there are five impor-ban-b 
considera-bions : 

Da-ba " ah ou-b -bhe de-bail characteristics of the organization 
must he available. 

. Known and' assumed facts that influence the operation of 

the organization should have q.uantif i able interrelationships. 

Knowledge of the relationships among organizational 
components is less reliable than knowledge of the 
individual components . 
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Construction of a model and observation of the interaction 
of its factors provide greater understanding of the 
operation of the organization. 

Results do not have to be perfect to be helpful. 

In actually designing the models a systematic approach is 
important. The f jlloving guide, "Steps in Model Design," is one vay to 
approach the model building task. 

Steps in Model Design 

Specify the planning ob^i'ectives ; The choice of significant 
objectives depends on the planner's knowledge of his organi- 
zation and on his ability to relate that knowledge to causes 
and effects. The final value to be derived from the model 
will be enhanced by the clarity of those objectives. 

Relate boundaries to the objectives : There are limits to the 
objectives. These must be taken into account if a realistic 
model is to be constructed. 

Identify items to be contained within the model : These are 
the organizational elements which have a significant bearing 
on the objective. The objective will determine the level of 
detail. 

Determine relationships between interconnected elements ; 
The relationship between planning items should reflect the 
relationships among elements of the organization. This must 
be done in a way that permits examination of the effects of 
the variables under study. 

Set item values at re^l^stic levels ; The current values of the 
variables must be set at levels that are valid, or if not 
known, are at least within reason. 

In designing a model, the normal procedure is to build upward 
from available knowledge about the individual planning items. In some 
cases, it may be desirable, or even necessary, to construct a variable 
by working backward from the known results. 

Once the model output is obtained, the planner, by examination 
and evaluation, determines which variables he wants to alter. This pro- 
cess of "exercising the model" by noting the various effects on a check 
line provides a basis for changing the model. 
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The end products of the model program^ the reports, are designed 
for tnaximum flexibility— again the planner designs his own reports and may 
even change the format of the report for each run. The information contained 
in any line of the planning model can be printed any number of times and 
in any sequence. The planner can create reports in the format that is ^ 
suitable both to his specific planning needs and to the overall needs of 
his institution. 

The east and flexibility of report design enable the planner to 
produce reports ranging from broad general summaries of the entire plan- 
ning model to detail analyses of specific elements of particular concern. 
Because the report design is flexible, the planner can adapt the format 
to the unique requirements of his organization and he can change the 
emphai^is of the report at any time, thus giving the report maximtom use- 
fulness in planning for the future. 

The planner can use the planning system we have described to 
experiment with virtually every aspect of the organization. With such 
experimentation he assesses the consequences of various alternative actions. 
Figure 2-3 shows the concept of a "plan refining cycle"— the iterative pro- 
cess of developing a long-range plan. By examination and evaluation of 
the system output, needed changes are identified and modifications can 
be made to independent variable values or dependent variable relationships. 

The planning system provides the planner with a niomber 
of alternatives in designing a model to represent his organization. How- 
ever, the freedom in both model and report design requires that the objec- 
tives of the organization be used as a basis for the planning process. 

Planning is a dynamic process. It must be responsive' to frequent 
change. The current trends of growth and complexity in the administration 
of education demand that today's planning be more accurate, rapid, and ex- 
tensive, than ever before. This computerized planning system provides a 
tool to meet that need. 
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CHAPTER 3 
mSIC ELEMENTS OF PIANTRAN II 



PLANTRAN II utilizes four basic types of input for the development of models: 

Type 1 - Identification Input 

Type 2 - Columnar Headings Input (optional) 

Type 3 - Model Specification Input 

Type 4 - Summary Report Input 
These four input types are shown belov on the PLANTRAN II data sheet. ^ 



NAME. 



OII6*Mrt4TlOM 



PLANTRAN H DATA SHEET 
IDENTIFICATION 

MOOKL OCSCRIPTION OATC 



PAGE OF. 



MRI(§I 



MM PCWIOO T M II 



1 24 


2S 






40 


41 








St 


57 to 


tl 


ts 


tt 


T-TIMC PtRlOO 
R-RCPLACCMCNT 


I" 


PCRtOO 1 


PtmoD 1 


pcmoo 9 






COLUMNAR HEADINGS -OPTIONAL 

PtmOOt »EltlOOT PCRIOO I PCKlOO • 




PCRIOO 10 


PCRIO 


0 II 




PtRtOO 11 


1 • 


7 


II 


IS 


II 


!• 


14 


IS 


so 


SI St 


ST 


41 


4S 46 


4t 


94 


9S 


•0 


tl 




tt 


t7 72 





t-IMI MO PLANNING ITCM 



MODEL SPECIFICATION 

ttSC LtVtL mEtFOWM MtTMOO OF COMPOTtTION 



40 41 44149 



Nf^OIIT TITLt 



SUMMARY REPORTS 

fRCCfORM REPORT LINCS 



1 24 


IS ,c 
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A discussion of each of the four input types follovs: 



I, Type 1 ■ IDENTIFICATION IltPUT 

The identification input is used to provide information for identifying 
the planning model, A sample of the identification input format is shown 
belov: 

IDENTIFICATION 

OWGAMlZATlOM MOOCL OCSCHlPTlOH 0*TE lAM PCRIOO T M R 



H>HCAOtNO 
R~RtRLaCHHWT 
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The format consists of eight fields, each of vhich contains several columns. 



Field 1 - Columns 1-24, ORGANIZATION, Contains the name of the organiza- 
tion. The name should begin with a non-niameric character to 
ensure that the first four characters cannot be interpreted as 
a numeric line number. 

Field 2 - Columns 25-40, MODEL DESCRIPTION- Contains a brief description 
of the objective of the model. Any character (alphabetic, 
numeric, or special) is permitted. 

Field 3 - Columns 41-56, DATE. Contains the date of the run. Any char- 
acter (alphabetic, numeric, or special) is permitted. 

Field 4 - Columns 57-60, BASE PERIOD. Contains the base period number, e.g. 

1971 — which is incremented by one for each period of the planning 
horizon, or^, is an indication of the sequence in which user 
specified columnar headings (Type 2 input) are to be reflected 
in the planning horizon. Only numeric data are permitted, and 
if less than four characters are present, they must be right- 
adjusted. 

Field 5 - Columns 61-62, T. Contains an indicator to specify the number 
of planning periods . A "T" or other character in either column 
generates a six-period planning horizon, and if the field is 
left blank, a 12-period planning horizon is assumed. 

Field 6 - Columns 63 -64, H. Contains an indicator to specify that user 
supplied columnar headings are provided. The "H" or other 
character in either column indicates that headings are provided, 
and if the "H" is present, the columnar heading input (Type 2) 
must follow. If the field is left blank, columnar headings are 
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generated in the system by incrementing the base period by one 
for each period. If the "K" field is left blank, the columnar 
heading input, Type 2, must not be included. 



Field 7 - Columns 65-66, R. Contains an indicator to specify vhether the 
model is a "stand alone" run or replacement data for an immedi- 
ately preceding model. The "R" or other character in either 
column indicates that the data -which follow are a revision of 
the previous model. If the field is left blank > the system 
treats the data as a "stand alone" model. 

Field 8 - Columns 78-80, WN NUMBER. Contains a character identifying 
the run. Both alphabetic and numeric data are permitted. 

In summary, the identification input (Type l) is used by the planner to 
provide infonnation for identifying the planning model run. 

II. Type 2 - COLUMMR HmUNGS INPUT (OPTIOmL) 

The optional columnar heading input allows the planner to specify columnar 
headings other than values incremented from the base period* A sample of 
the columnar heading input format is shown below. 



"T 7 



PERIOD 5 rimOO 4 



COLUMNAR HEADINGS -OPTIONAL 

f EmOO 9 PERIOD • PERIOD T PEKIOO • PERlDO » PERIOD 10 PERIOD I I 



The format consists of 12 fields of six columns each: 



Field 


1 


- Columns 


1-6, PERIOD 1. 


Field 


2 


- Columns 


7-12, 


PERIOD 2. 


Field 


3 


- Columns 


13-18, 


PERIOD 3 


Field 


4 


- Columns 


19-24, 


PERIOD 4 


Field 


5 


- Columns 


25-30, 


PERIOD 5 


Field 


6 


- Columns 


31-36, 


PERIOD 6 


Field 


7 


- Columns 


37-42 , 


PERIOD 7 


Field 


8 


- Columns 


43-48, 


PERIOD 8 



o 
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Field 9 - Columns 

Field 10 - Columns 

Field 11 - Columns 

Field 12 - Columns 



49-54, PERIOD 9. 

55-60, PJEIOD 10. 

61-66, PERIOD 11. 

67-72, PERIOD 12. 



Note that there are three relationships between the columnar heading input 
and the identification input. 

First, the H field of the identification must contain the char- 
acter "H" to initiate the planner specified columnar headings. 

Second, the BASE PERIOD field of the identification input can 
be used to specify which of the columnar headings is to be printed as the 
first period on the reports. For example, if the columnar headings contain 
the months of the year beginning with January, and if the BA.SE PERIOD field 
contains a "6" then the PERIOD 6 entry (June) will be considered as the base 
period and PERIOD 7 (July) will be printed as the first planning period. 
This capability enables a plan to be updated by simply changing the identi- 
fication input. 

Finally, the T field indicates whether 6 or 12 columnar headings 
will be printed, i.e., blank indicates 12 periods, T indicates 6 periods. 

III. Type 5 - MODEL SPECIFICA.TION IMFUT 

The model specification input is used to build the model — that is, 
to project and interrelate planning items. This simple set of model speci- 
fication instructions reflects projection techniques in common use and uses 
an English-like syntax. A sample of the model specification input format 
is shown below: 

MODEL SPECIFICATION 

l»L*W»»»fC ITCW B»SE LtVtL 'FftEEFORM ME7»tOO OF COMPUTATI&W 




The format consists of four fields. An explanation of their use follows. 

Field 1 - Columns 1-4, LINE NUMBER . Contains a line number associated 

with t planning item. Only numeric data are permitted, and the 
number may be placed anyvhere in the four columns. 

Field 2 - Coiuimis 5-28, PLAMMING ITEM . Contains a description of the 
values associated with the row of the planning matrix. Any 
characters (alphabetic, numeric ^ or special) are permitted. 

Field 3 - Columns 29-40, BASE LEVEL > Contains the value for the base 

period of the planning item which may be an integer or a real 
number; that is, a decimal point is optional. 
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The data must be numeric, with the exception of the decimal 
point (.) and the plus (+) or minus (-) signs. 



Commas are not permitted ! 

Field 4 - Columns 41-80, FREEFORM METHOD OF CCMPUmTION. Contains an 
English -like statement which develops a projection, or ex- 
presses the relationship between this and other planning items. 
Each method of model specification has certain required ele- 
ments, reserved characters, and optional elements which are 
discussed below. The length of an individual entry is limited 
by the number of columns on a single punched card. If a cer- 
tain model specification method exceeds the limit of one card 
(80 columns), a notation must be made to indicate that the 
statement is continued on the following card. This notation 
is a ^'C^^ which appears on the last card entry. 

The planning item row values may be simple extensions of the 
current or base value of an item. These values are based on independent 
methods of projection. 

The plaiining item row values may also be functions of other 
planning item row values j with interrelationships specified by the planner. 
Biese values are determined by dependent methods of projection. 

It is the process of specifying each of these planning items — 
determining how they are to be projected and how they are related to 
other planning items --that constitutes model building. The ease and sim- 
plicity of specifying each of the planning items belies the complexity 
that the completed model may represent. The relatively simple static 
model is made complex by dynamic changes in planning items through time, and 
even by dynamic changes in relationships among items. 

Planners can use the model specifications to deal with individual 
planning items with ease and simplicity. At the same time, they may com- 
bine these items in an almost endless variety of ways to build a model of 
any desired complexity. 

A. Independent Methods of Projection 

Independent planning items can be projected in one of four ways. 
These four methods are compatible with manual planning techniques. 

1. Change by a percentage 

A planning item may be changed (either increased or decreased) 
by a specified percentage. This method generates a compound percentage 
increase or decrease for each planning period* An optional feature allows 
the planner to specify the period in which the percentage change begins. 



a. Required elements 



The BASE LEVEL field must contain a value. 

The FREEFOBM METHOD OF COMPUTATION field must contain: 

• One of the following terms in the first four positions 

o.f the field; 

rniironu method of coMPuuTroN 

41 44)49 

fiei^ 

la^ 

fcr I - 

• A reserved character "I", "D", or after column 44, 

where: 



I - represents an increa.se 
D - represents a decrease 

(-)- a minus represents a decrease. This symbol is to be 

placed immediately preceding the percent value. If none 
of the above characters are used, an increase is assumed. 



A percentage value, which may be an integer or a real 
number. (Note that this value is expressed as a percent value, i.e., 6 
percent, rather than bhe 0.06 decimal eq.uivalent . ) 

An instruction to maintain a constant value throughout each 
planning period (increase by zero percent) may be indicated by inserting 
a zero (O) as the percentage value or by leaving this field blank in the 
FREEFOBM METHOD OF COMPUTATION , Another instruction which will result in 
the same projection uses a CONS (for constant) in the first four positions 
(Columns 41-44) of the FREEFORM METHOD OF COMPUTATION with the remainder of 
the field left blank. The EASE LEVEL field must contain the constant value 
that is to be maintained throughout each period. Example (3) illustrates 
trates alternative instructions to maintain a constant value in each plan- 
ning period. 

b. Optional elements 

The percentage increase or decrease may be delayed through use 
of the "beginning in" operand, and the specification of the period in which 
the change is to begin. To use this option, the planner must use a term 
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containing the reserved character "B" after the percent value and prior to 
an integer specifying the period in vhich the change is to occur. The 
default option is to "begin the change in period 1. 

Examples: 

(l) Percentage increase of 10 percent per period. 





FntEFONM METHOD OF COMPUTATION 

41 44I4S ~ ~ao 

P£ftdEA/T XAfCJfE^ OF /O per f£l^ PUilOD 


looo 








dooo 


PCT\ 10 



(2) Percentage decrease of 5 percent per year. 

B4SC LEvet FWEEFOI>M METHOO OF COMPUTATION 



40 

tooo. 




±D0O 










ftT i -5 



(3) Constant value of 1000 to be maintained each period. 



2* 40 

±000 


4» 44I48 80 

f£^em XAtCREAS£ OP- O p£R P£RXOD 


looe>» 


cous^nmrr vju,ue mnjj^xvBO £Ac.y P^ktop 


dooo 


QOWSI 



(4) Percentage increase of 7.5 percent per year beginning in third 
year. 

BASt LEVtL FWEEFOWM METMOO OF COMPUTATION 



29 40 


pmci£n>T ZNc^E*^^E. IS par Uffihf 3j^d mxot> 


±ooa 




^000, 




±coe> 


Pcr\l,SB3 
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(5) Percentage decrease of 5,47 percent per year beginning in sixth 
year • 



aASE LEVEL 

looo. 


FMEEFOMM METHOD Or COMPUTATION 

Pf/tif/i'r z>e£<?e^e 3.-*^ per bbsw LTHfaaoi 


icon 






?cr j -3. ^7 % 3 ^ 


^000 





(Notes on reserved characters,) 

The characters "l" (increase), "D" (Decrease), or have mean- 
ing prior to the percent value. The character "B" (Beginning in) has 
meaning between the percent value and the beginning period value. 

2. Change by an increment 

A planning item base value may be changed (either increased or 
decreased) by a specified incremental amount. This method generates an 
incremental value increase or decrease for each planning period. The be- 
ginning period in \^ich the incremental change occurs may be specified, 

a. Required elements 

The first four positions of the FRKFFORM METHOD OF COMPUTATION 
field must contain one of the following terms: 



FWEEFOBM METhOO OF COMPUTATION 



Hi 
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The FREEFORM METHOD OF COMPUTATION field must contain an incre- 
mental value, ^ich may be an integer or a decimal number. 

b. Optional elements 
If the BASE LEVEL field contains no value, a value of zero is 

assumed. 

The incremental increase or decrease may be delayed througih use 
of the "beginning in" temi and the specification of the period in which the 
change is to begin. To use this option the planner must use a term con- 
taining the reserved character "B" after the incremental value and prior 
to an integer specifying in which period the change is to occur. The de- 
fault option is to begin the change in period 1. 
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Examples : 

(l) Incremental increase of 100 per year. 



SASE LEVEL 


40 


FRECFORM METHOD OF COMPUTATION 

TiJtj?iy/»Sf 8V dao PER P£«X0D 


00 








EucpI loo / Pf amo 









(2) Incremental decrease of 50 per year. 



BASE LEVEL 
!• 40 


FREEFORM METHOO OF COMPUTATION ^ . 


Jooo 


DfC^I so/ PhUSOO 




DEO?! 5T>y PE^11>0 


IDOO 


nfii^i fro 



(3) Incremental increase of 35.5 per year beginning in fifth year. 



SASE LEVEL 

40 

±QO0. 


FREEFORM METHOO OF COMPUTATION 

xmiBASE BV 3S',S'/FBKHa> 9ECLn/ ST» PBRxS 


dooo 




loco. 




±000 





(4) Incremental decrease of 72. "57 per year beginning in fourth year. 



BASE LEVEL 
IB ^ _ 40 


FREEFORM METHOO OF COMPUTATION 


looo 




4000. 




dOOO 





(Notes on reserved characters.) 

The character "B" initiating the "beginning in" option, has 
meaning between the incremental value and the beginning period value. 



I 



3. Change to achieve goal 

A planning item base value inay be changed (either increased or 
decreased) to a specific goal value, \jhich may be an integer or a decimal 
number, in a specific number of planning periods. This method generates 
values \^ich increase or decrease from the base value to the goal value, 
then retain the goal value for the remaining periods in the planning 

horizon. The period in \^ich the increase or decrease change begins may 
be specified. The base value and/or the goal value may be negative, speci- 
fied by a minus sign (-) preceding the number. 

a. Required elements 

The first four positions of the FREEFORM METHOD OF COMPUTATION 
field must contain the following term: 

FHECFORM METHOD OF COMPUUTlON 

41 44I4S 

GOAl\ 



The FREEFORM METHOD OF COMPUTATION field must also contain a goal 
value, which may be an integer or a decimal number, and an integer which 
specifies the period in ^ich the goal is to be achieved. A blank space or 
non-numeric character must separate the goal value and the integer, noting 
the period in \^ich the goal is achieved. 



b. Optional elements 



If the BASE LEVEL field contains no value, a value of zero is 
assumed. The change from the base value to the goal value may be delayed 
through use of the "BEGINNING IN" term, and the specification of the period 
in \^ich the change is to begin. To use this option the planner must use 
a term containing the reserved character "B" after specifying the period in 
\^ich the goal is to be achieved and prior to an integer specifying the 
period in which the change is to occui • The default option is to begin 
the change in Period 1. Note that if a negative goal value is specified, 
the difference between the base and goal values will be the algebraic dif- 
ference. 



Examples : 

(1) Change to a goal of 1500 in fifth year. 



>• . 40 








looo 






eoAL\ is-co 5" 



Er|c 3-10 



(2) Change to a goal of 720 in 6 years. 

SftSE LEVEL FREEFORM METHOD OF COMPUTATION 



±ooo. 




icoo 


^e>M\ 1-2.0 E/V PEKlOX> 


iJbOO, 









I 



(•''0 Change to a goal of 2100 in 8 years beginning in fourth year. 

BASE LEVEL FREEFORM METHOD OF COMPUTATION 



40 






ea^l iloo r/u 77// BefirAf 








^100 ? 8 



(4) Change to a goal of 933.3 in 5 years "beginning in second year. 

I 

e*SE LEVEL FREEFORM METHOD OF COMPUTATION 



«• 40 

lce>o 


41 44 


0^ ^33.3 Znf S7^ peRi^ Ze^hfW ZMD 


±000 




93^.3 Xf\; %B6ZN -Xnto 


icoo 




933.3 ^rH BB^x/U Aiuo 


4000 


$e»L\ 933. 3 5* 3 a 



(Notes on reserved characters.) 

The minus sign (-) notes that the goal value is negative. The 
character "B" (Beginning in) has meaning between the period in which the goal 
is achieved and the beginning period value. 

4. User supplied data 

The planning item values may be inserted for any or all of the 
12 planning periods. This method permits the planner to insert irregular 
or known data, integers or decimal numbers , into the appropriate periods 
of the planning horizon. 

a. Required elements 

The first four positions of the FKSEFORM METHOD OF COMPUTATION 
field must contain the following term: 

FREEFORM METHOD OF COMPUTATION 

41 44l4ft 
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The remaining portion of the FREEFORM METHOD OF COMPUTATION field 
is then used by the planner to insert period values, .either integer or deci- 
mal ! numbers, into the appropriate planning periods. The comma (,) is used 
to separate planning period values. If no value is provided between ::ommas5 
a zero is assumed for that period. If adequate space is not present in the 
FREEFORM METHOD OF CCMPUTATION field on one line, the character "C" is used 
to continue t'ne data to column 45 of the FREEFORM METHOD OF COMPUTATION 
field on the next line. The "C" may be inserted following a period value 
or a comma delimiter but must not be used to split a data item from one line 
to the next. 

b. Optional elements 

The base level value is not required. Negative period values may 
be specified by preceding the period vnlue with a minus sign ( -) . 

Examples : 



(^) Insert the following values — base 


value 1 


.0. 




Period 1-1.06 


Period 


7 


- 1.08 


Period 2-1.05 


Period 


8 


- 1.09 


Period 3 - 1.04 


Period 


9 


- 1.09 


Period 4-1.04 


Period 


10 


- 1.10 


Period 5-1.06 


Period 


11 


- 1.09 


Period 6-1.07 


Period 


12 


- 1.08 



BASE LEVEL 


FREEFORM METHOD OF COMPUTATION 







(2) Insert the following values — no base value. 



Period 


1 


- 105 


Period 


7 


0 


Period 


2 


0 


Period 


8 


- 141.9 


Period 


3 


- 115.5 


Period 


9 


- 150 


Period 


4 


- 121.3 


Period 


10 


- 163.2 


Period 


5 


- 122 


Period 


11 


0 


Period 


6 


- 138 


Period 


12 


- 170 



■ ASK kCVSk 






! is-o] jL3:2y. no ' 
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(3) Insert the following values --no base value. 



Period 1 
Period 2 
Period 3 
Period 4 
Period 5 
Period 6 



19174 
0 
0 

23406 
0 
0 



Period 7 
Period 8 
Period 9 
Period 10 
Period 11 
Period 12 



3O005 
0 
0 

38914 
0 
0 



BASE LEVEL 



FWEEFORM METHOD OF COMPUTATION 



hm^mij^^ 23^66>y^^ joQaTjjj 3^9 f<l 



(4) Insert the following values --base value 1150. 



Period 1 


- 1150 


Period 


7 


- 1450 


Period 2 


- 1250 


Period 


8 


- 1550 


Period 3 


- 1250 


Period 


9 


- 1550 


Period 4 


- 1350 


Period 


10 


- 1650 


Period 5 


- 1350 


Period 


11 


- 1650 


Period 6 


- 1450 


Period 


12 


- 1750 



2B 40 

fiso. 


41 44I4S ^ _ _ SO 

mrA\ f/sro^ iz.S'o, izs£>j i3£X>j i^s-o, i-iso^ c 




\ i^irdj AssrOj fSsc^ /LSOj JloS^^ nSO 



(NoteF on reserved characters.) 
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The reserved characters for the DATA method are the comma 
used to delimit or separate planning period values --and the character "C 
indicating a continuation of the data to the next card. 

The range of the data to be inserted is ± 999 999 999 999.9999 



B. Dependent Methods of Projections 

The methods of generating dependent planning items are the most 
powerful means of model specification. The ten methods of dependen-c pro- 
jection may be used to interrelate planning items in almost unlimited 
combinations. 

i. Summation of other planning items 

A planning item may be the summary of up to 15 other planning 
items. This method permits totals, subtotals, etc., to be pyramided. Th 
summation planning item provides the appropriate suiraned values for each 
period in the planning horizon. 
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a. Required elements 



The first four positions of the FREEFOEM METHOD OF COMPUTATI ON 
field must contain the following term: 

FWEEFORM METHOD OF COMPUTATION 

141 44I49 
siftn I 



Note that coliamn 44 must be blank. 

The FREEFOEM METHOD OF COMPUTATION field must contain the line 
uambers of the planning items to be summed. A total of up to 15 planning 
items line numbers, separated by a comma (,) may be summed* 

b. Optional elements 

Use of the BASE LEVEL field is optional. The planning item line 
numbers may be preceded by the character "L", for example L 14, L 19, L 29, 
etc. If the length of the FREEFORM METHOD OF COMPUTATION field is not 
sufficient to contain all of the line numbers, the character "C" may be 
used to continue the line numbers to the next data sheet fomat, beginning 
in Column 45. 

Examples : 

(1) Summation of lines 26, 84, 18, 59, and 45. 



2» _ 40 

±000, 




loco 






sum 1 e>fi LU, L%4^ U9f L39j L ^S" 




fm 1 2^, i4\ 19, 39, us- 


Summation of 

BASE LEVEL 


uries 2, 7, 12, 14, 15 , 26 , 31, 47 , 86, 103. 

'REEFORM METHOD OF COMPUTATION 


Z% 4b 






I 47. I03 




sum Ldj LI, Lllj U<j US-y l-a<.,Ul^C 








sum 1 2 T llj Mj /5. ^7^ id 3 
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(Notes on reserved characters.) 



The comma '^/^ and the character "C^ have signif icance, the comma 
being the delimiter "between line numbers ^ and the "C" indicating that ad- 
ditional lines are to be included in the sum and are specified in column 
45 of the next card. 

2. Shifty or shifted function^ of a previous or future 
planning item value: 



A planning item may be a shifty or shifted function , of another 
planning item which is shifted forT-zard or backwards a specified number of 
periods along the planning horizon. 

a. Required elements 

The first four positions of the FREEFQIM METHOD OF COMPUTATION 
field must contain the following tem: 

FREEFORW METHOD OF COMPUTATION 

41 44Us ' 

SJfXfi 



The character "L" must be used, preceding the line number of the 
planning item which is to be shifted. The default option produces a shift 
of the specified planning item value one period forward^ or to the 
right. The BASE LEVEL value, if present, i£ included in the shift. 

b. Optional elements 

The shifted values may reflect a planner specified function^ i.e., 
a signed constant value times the value of the shifted line. The 
absence of a sign before the constant is understood to mean a positive 
factor J and a minus sign (~) indicates a negative multiplier. The constant 
value may be an integer or a decimal number. 

For a shift of more than one period forward (right), or for a 
shift backward (left) of one or more periods, the reserved characters "F'' 
or ''B", or a term containing these characters may be used. These characters 
must be followed by an integer specifying the number of periods forward 
or backward that the planning item values are to be shifted. The use of 
the optional constant function with the "F" or "B** reserved characters is 
the same as with the one period forward shift. 
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Examples : 

(l) Shift line 31 forward (right) one period. 

BASE LEVEL FREEFORM METHOD OF COMPUTATION 





40 


41 44I45 * . » *° 


)000, 




/ooo. 




Shift line 

BASE LEVEL 


16 forward (right) 3 periods* 

FREEFORM METHOD OF COMPUTATION 






41 44145 *0 


looo 


SWipjT UL PORVJ^D 3 PSHte>t>£> 


JOOO 


^IF|T LIU 3 


JODO 




Shift 0.75 

BASE LEVEL 


times line 31 backward (left) 6 periods. 

FREEFDRM METHOD OF COMPUTATION 




40 


41 44145 ^ "0 


looo. 


stfTFlr nS' L5i awA; 6> perxoos 






IDOO. 


0/i/=i .75 LSI 8 (p 


Shift 1.043 

BASE LEVEL 


times line 86 forward (right) 2 periods* 

FREEFORM METHOO OF COMPUTATION 




40 












lOOO 





(Notes on reserved characters.) 

The character *'L" must be used preceding the line number, and 
between the planner specified constant and line number if that option is 
desired. 

The minus (-) must be used with a constant if a negative constant 
is desired* 
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The ^'F'^ must be used if a shift forward of more than one period 
is desired^ and must be bet'ween the line nimber and the integer specifying 
the number of periods to the right. 



The ^'B'^ must be used if a shift backyard is desired and must be 
bet'ween the line niomber and the integer specifying the number of periods, 
to be shifted. 



values 



User su TOlied equation or function of other planning itpj n 



A planning item may be a planner specified equation or function 
of up to four other planning items times optional constant values, in 
combinations of addition, subtraction, multiplication, division and ex- 
ponentiation. Use of parentheses is permitted. 

a. Required elements , 

The first four positions of the FREEFQEM METHOS OF COMFUl'ATION 
field must contain one of the folio-wing terms: 



FREeFORM METHOD OF COMPUTATIOH 



41 4^145 



eat/A 



The equation is specified to the planner, and it is developed 
through use of the following form: 



Ci L;l 





^3 % 




-where C is the constant value. 



L is the line number. 



+ indicates addition, 
- indicates subtraction, 
* indicates multiplication, 
/ indicates division, 
and ^ indicates exponentiation. 
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The hierarchy of operations in solving an equation is perfomed 
sequentially from left to right in the follo>ring order: 



1st - C L, the implied multiplication of a constant times a line 
number, 

2nd - ( ), the operation specified between parentheses. 
3rd - ^5 exponentiation. 

4th - ^ and j ^ multiplication and division. 
5th - + and addition and subtraction. 

Double nested parentheses, e.g., L 16 (L 14 ^ (1.043 + L 19)) 
^Q"*^. permitted. An implied multiplication before an expression in 
parentheses, e.g,, 10 (L 71 - L 43) is not pennitted. 

b. Optional elements 

Use of the BASE LEVEL field is optional. Base level values are 
not used in the specified operations . The character "C" may be used to 
continue the equation to column 45 of the next line of the data sheet. 

Examples : 

(l) Multiply line 71 by the' sum of lines 84 and 86. 



2» 40 

/ooo. 




]ooo 




looo. 





(2) Divide line 19 by line 6 and multipy the result by 1.005. 



BASE LEVEL 
Z9 40 


FREEFOfiM METHOD OF COMPUTATION 

41 44I45 i ^ ^ 
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(3) Multiply a constant of 94,32 by line 63 and subtract line 104 
from the product. 



BASE LEVEL 

29 40 


FREEFORM METHOD OF COMPUTATION 

a{)7Vl"9^.3a -if- UHm - LIMB iO"^ 


no 




ECTA^ LIVE 63- Unf£ 10-^ 






Square the values of line 163 . 

BASE LEVEL FHEEFORM METHOD OF COMPUTATION 


29 40 


£<P7W UAJE iLl VJ^ 0 


AO 




C^/Vf LiL3, -if¥D. 







(Notes on reserved characters.) 

The character ^'L" must precede a line number, and must separate 
the constant and the line number in an implied multiplication of a constant 
times a line. 

Only three of the arithmetic operators, "-"3 and 

""^^ may be used in one equation statement. 

The decimal may only be used in conjunction mth a constant 

value . 

The continuation indicator "C", if used, must be the last character 
on the data line. In using a continuation, the equation cannot be separated 
between the double asterisks "-3^^' or between the character "L" and the line 
number. 

4 . Maximum or minimum of up to four other planning items and a 

constant ; 

A planning item may be the maximum or minimum of up to four other 
planning items and a given constant, period by period, across the planning 
horizon. 

a. Required elements 

The first four positions of the FREEFOBM METHOD OF COMRJTATION 
field must contain one of the following terms: 
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FWEEFOWM MCTMOP Or COMPUTATION 



To produce -btie maximum. 
To produce "bine minimum. 



The balance ol* -btie .b'KE.b'.bDHiyi lyEETHOD OP COMPUTATION must: contain at least 
tvo planning item line mombers, or one planning item line number and a 
constant value. The line niambers must be preceded by the character "L. " 
The comma " must be used to separate line numbers and/or the constant 
value . 



b . Optional elements 

Up to four line numbers may be compound. The optional constant 
value may be signed, and it may be an integer or a real niamber. 

Examples: 

(l) MaximiJm of lines 18, 27 , 36 ^ and 4=5, 



BASE LEVEL 


*o 


frEcform method of computation 

iiiAii£\rnum ofz UZ. LAT. L^J^ 


BO 




/n4J^r{ OP L,i^f Z-ilj L'3C, 




/nM i i. /«j L:<tS' 


Maximum of* 

BASE L£VEL 


l3 


J3,es 26, 47 J and a constant; value of 2500. 

FREEFORM METHOD OF COMPUTAriOM 




40 




• O 




jnmtij OP l^rxLj ^<'7j i:^oO 




fhM ; L2.6.1 l_<-7; 2Lfi-00' 


Minimum, of 

BASt LEVEL 


lirLes 104, 127, 139, 182. 

FREEFORM METHOD OF COMPUTATION 






40 


nix/iariwi'i*) of? »a7> 


no 











(4) Minimum of lines 206, 239, and a constant value of -14.63, 



BABC LEVEL 



ERIC 



nrECFOHM METHOD OF COMPUTAT ION 

77f 
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(Notes on reserved characters,) 

The character "L" must precede all line numbers. 

The comma "j" must be used to separate line numbers and/or the 
constant value. 

The minus preceding the constant value indicates a negative 
number. The absence of the minus sign denotes a positive constant value, 

5, Filling ^aps in a specified data planning item or projecting 
another planning item 

FILL A planning item may be the complete series which results 

from fillin'5 the gaps in data specified in another planning 
item, 

PROJECT A planning item may be the projection of another planning item, 
resulting in a linear forecast. 

Both of these options use a technique of semi -averaging, in which 
input data are separated into two parts and the data averaged in each part, 
A trend line is then calculated between these two averages. Missing data 
in the FILL option are derived and corresponding values inserted in the 
planning periods. For PEOJECT, the trend line values are extrapolated for 
the next 12 periods. 

Special note : These methods are applicable only when the trend is linear 
or approximately linear I 



a. Required elements 

The first four positions in the FREEFOEM METHOD OF COMPUTATION 
field must contain one of the following terms: 

fWEEFOmi METMOO Of COMfUUTION 



EJiM 



\'!*' "I To fill in missing data. 



pH gfl| To project data. 

The FREEFOEM METHOD OF COMPUTATION field must contain the line number of 
the planning item to be filled or projected. 



b. Optional elements 

Use of the BASE LEVEL field is optional. The character "L" may 
be used to precede the line number. 
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Examples : 



(1) 



Fill missing data in line 73. 

KAfC LEVEL f REEfOIIM mCTHOO Of COMMUTATION 


n 40 


41 44149 aO 

PH.LI Lwt ^^ 




p/a| L-73 






Project data 

8*$e LEVEL 


in line 106. 

FRCCKORM MCTMOO OF COMPUTATION 


n 40 

— 


41 44l4ft flO 






— ■ 


Paoi'i L IDC 







Notes: These methods develop a time series very similar to that resulting 
from use of a linear regression routine. 



6. ' Accumulative sura or accumulative product of another planning 

item 

A planning item may be the accumulative sum or product of the 
period values of another planning item across the planning horizon. 

a. Required elements 

The first four positions of the FREEFORM METHOD OF COMPUTATION 
field must contain one of the following terms : 



FRCEFORM METHOO OF 
4t 44148 


COMPUTATtON 






Accu! • . . 


s 


— \ 




jictvl • • • 


p 



] 



For accumulating the sura 
For accuraulating the product 



The FREEFORM METHOD OF COMPUTATION field must contain the required 
characters '^s," indicating sum, or "P," indicating product, if the "ACCU" term 
is used. 

The line nuraber of the planning item must be present in the field. 
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b. Optional elements 

Use of the BASE LEVEL field is optional. If values are present 
in the field of the planning item line "being accumulated, they mil be 
included in the computation. In using the accumulated product option, if 
no value is reflected in the BASE LEVEL field of the planning item line 
being accumulated, a value of one is inserted by the system. 

The character "L^' may be used to precede the line number. 

Examples : 

(l) Accvimulate the sum of line 43. 



BASE LEVEL 



FREEFQRM METHOD OF COMPUTATION 



29 40 






4cct/jinuL47e si/m L/^fe 






1 








Accumulate the product of line 47. 

flASE LEVEL FREEFQRM METHOO OF COMPUTATION , 


?9 -«n 


OCCiAthULmE TUB PnoDUCT OF UlUB -^7 








*CCl/| PRODUCT L<ll 








ACt9\ "9 "7 



(2) 



(Notes on reserved characters.) 

The "S" or "P" may either be included .in the form "ACCS" or "ACCP" 
in columns 41-44, or they may be in any term in the FREEFQRM METHOD OF 
COMHJTATION field. 



7. Punch planning item line values 

The planning items may be specified to be output on punched cards 
in the format of the user supplied DATA input. Up to 15 planning item lines 
may be specified. The resulting DATA cards are generated, using the speci- 
fied line numbers with tTO period values per card. 
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a. Required elements 



The first four positions of the FP^TORM METHOD OF COMPUTATION 
field must contain the following term: 



FWECrOWM METHOD OF COMPUTATION 



The FREEFORM METHOD OF COMPUTATION field must contain the line 
numbers of the planning item, lines to be punched, separated by a comma. 

b. Optional elements 

The BASE LEVEL field is optional, and if specified vill be 
punched in the appropriate field in the output card. 

The planner may specify that the planning items be given different 
line numbers by using the "AS" option. This instruction permits a statement 
such as : 

FWEEfOWM METHOD Of COMPUTATION 



l4i 4414ft 



This statement generates cards which contain the planning item 
terms and period values so that line 3 becomes line 107, line 17 becomes line 
141, and line 24 becomes line 190. This capability is significant if the out- 
put from one model is to serve as input to another. In such a case, the line 
number of the data generated by the PUNC instruction in the first model is 
determined by its intended seq.uence in the second model. (There must be 
the same number of line numbers specified on each side of the "AS" term.) 

The planning item line numbers may be preceded by the character 
"L." If the length of the field is not sufficient to contain all of the 
line numbers, the character "C" may be used to continue the data to column 
45 of the next data line. 

Examples : 



(I) Punch .lines 2, 3, 4, 5, 6, 7, 8, 9, and 10. 



■A«E LEVEL 

ft 40 


FREEFORM METHOD OF COMI^UTATION 

*fWm UM£& Qf5j L 7. 7, % JO ^ 




PuMdrt ll'. LnjL? no 







ERIC 
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(2) Punch lines 20, 22, 26, as lines 91, 107, 114. 

BASE LEVEL FWEEFQBM METHOD OF COMMUTATION 





. 









(3) Punch lines 109, 131, 146, 152, 180, as lines 31, 46, 16, 9, 71. 



BASK. LEVEL 
2* 40 


41 44I 


HETHUD gP COMPUTATigN 
4» . , 80 























(Notes on reserved characters.) 

The comma " is the delimiter between line numbers. 

The character "C" indicates that the line numbers are continued, 
beginning in column 45 of the next card image. 

The character "A" indicates that the line numbers are to be re- 
placed by user specified seq.uence of line numbers following the "A/' 

8. Average of another planning item 

A planning item may be the accumulated average of another planning 
item, computed period by period across the planning horizon. 

a, Required elements 

The first four positions of the FREEFORM METHOD OF COMHJTATtON 
field must contain the following term: 

FWEEFORM METHOD OF COMPUTATION 
41 44I46 =1^=^= 

flwefi . 

The FKEEFOEM METHOD OF COMPUTATION field must also contain the 
line number of the planning item to be averaged. 



ERIC 
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Optional elements 



Use of the EASE LEVEL field in the line to be averaged is optional. 
If a BASE LEVEL value is provided, this value vill be included in t' j com- 
putation, developing an average based on 7 or 13 values (depending on whether 
there are six or twelve planning periods). If the BASE LEVEL value is not 
provided, the running average is based only on data contained in the actual 
planning periods. 

The line number may be preceded by the character "L". 

Examples : 

Running average of line 17 . 

SASE UEVEL rWEEFOBM METHOO Of COMPUTATIOM 



t» «0 


fNEftME Of UNh 


n 


BO 




fUf^l(Mt Of' Ln 









flUERl n 


9. Plot of 


up to four planning 


items 





A printer plot of up to four planning items may be specified. The 
plot is developed with the vertical axis at zero or a self-scaling feature 
may be specified which has the effect of shifting the plot toward the ver- 
tical axis. Negative numbers in a planning item can be included in a printer 
plot by use of the self-scaling feature. 

a. Required elements 

The first four positions of the FREEFORM METHOD OF COMPUTATION 
field must contain the following term: 

FWEgFOWM METHOO Of COMPUTATION 

41 44146 

PLOt ^_ 

The FREEFORM METHOD OF COMPUTATION FIELD must contain the line 
numbers of the planning item lines to be plotted, specified as integers. A 
maximum of four planning item line numbers may be plotted and must be 
separated by a comma " in the FREEFORM METHOD OF COMPUTATION field. 
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b. Optional elements 



The reserved character "S/' or a term containing that character, 
may be specified by the planner to note that the actual value of negative 
niOTbers is to be reflected or that the vertical sixis is to have a value 
other than zero. The "3*' indicates that self -scaling is to be generated 
b:*" the system. 

The planning item line numbers may be preceded by the character 

Examples : 

(l) Plot line 14, line 15, and line 16, 



BASE LEVEL 

» 40 


FREEFORM METHOO OF COMPUTATION . _ 




fLOt, LHj LUfi UW 







(2) Plot line 27, line 43, line 12, and line 91 using the self -scaling 
feature . 



BASE LEVEL 
t% 40 


PREEFORM METHOO OP COMPUTATION 

'IrLdTuMF'C, J 7, <3 . <?l SELf SCAU/JG 








RLOTj 5-7^ i?3j raj S 



(iNIotes on reserved c*^aracters • ) 

The comma and the character "S" have significance, the comma 
being the delimiter between line numbers and the "S" indicating that the 
self -scaling feature is desired. 

10. r eturn on Investment 

A planning item may be the percentage return on investment which 
would result from a cash flow represented in another planning item line. 

a. Required elements 

The first four positions of the FKBEFORM METHOD OF COMPUTATION 
field must contain one of the following terms : 

«^ 

•REEFORM METHOO Of COMPUTATION 

41 44^4^^^^ ^^^^^^^^^^^^ 

fiEI?^ 

ROL I , 
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The FREEFORM METHOD OF COMPUTATION field must also contain: 



• An integer indicating the number of periods over vhich the 
return on investment is to be calculated; (the number of periods canno"^ 
exceed the number of planning periods defined in the Plan Identification 
Card. ) 

• The line n\mber of the cash flow planning item for which the. 
return on investment is to be calculated; 

• A character "B" or a term containing that character and an 
integer specifying the period in which the return on investment calculation 
is to begin. The "B" must appear after the line number and prior to the 
integer specifying the beginning period. If the base period is to be in- 
cluded, this integer should be zero. 

If the values of the cash flow line do not contain .at least one 
negative value and one positive value, the number "-9999 .99" will appear in 
each period of the resulting return on investment line, indicating invalid 
input • 

Examples : 

(l) Return on investment over 12 years on line 73. 



29 40 


4t 44I48 00 

Rewifinf 6vtR 12. PtnxcDS Lft\fi 73 Ce^/A/ JST 










Hoi \ iz 73 81 



(2) Return on investment over 9 periods for line 87 beginning in the 
second period. 



tt 40 

















ERIC 
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(Notes on reserved characters.) 



The sequence of characters must "be as follows: 



First - an integer showing the number of periods over which the 
computation is to "be calculated; 

Second - an integer showing the line number or the planning item 
for which the computation is to "be made; 

Third - the character "B" or a term containing "b"; 

Fourth - an integer showing the planning period in which the com- 
putation is to begin. 



C. Headings or Section Titles 



Ixi addition to the independent and dependent methods of projection, 
there is the capability of separating report sections with headings or 
section titles. 



Required elements 

The first four positions of the FREEFORM METHOD OF COMPUTATION 
field must contain blanks or the following term: 



FREE FORM METHOD OF COMPUTATION 



This instruction places the data contained in the PLANNING ITEM 
field in the center of the report output. The heading or section title 
planning item is referenced in a Summary Report input format (see type 4 
below) by specifying the line number of the planning item containing the 
heading or section title. 



Examples: 



A heading mth a title of "SAMPLE OF HEADING USE" and line number 125 . 



LIME MO PLAMMINC ITEM 



rWEEFOWM MCTMOD OF COMPUTATION 

^^^^^-•Us ^^^^^ 



MEM 



ERIC 
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IV, Type 4 - SUMMARY REPORT INPUT 



The SUMMARY REPORT input is used to specify a svunraary report 
title, the individual planning items to be contained in that report, and 
optionally, the scale of the period values to be printed. 

A sample of the siHumary report input format is shovn below: 

SUMMARY REPORTS 

Rt^O»T TITLt FNCEFORM REPORT LINES 



ERIC 



The format consists of two fields with the following designations: 

Field 1 - Columns 1-24, REPORT TITLE . Contains a title, provided by the 

planner that is to appear on the report. Any characters --alpha- 
betic, numeric, or special — are permitted. 

Field 2 - Columns 25-90, FREEFORM REPORT LINES . Contains the scale factors 
(optional) and the line numbers of the planning items that are to 
be included in the summary report, 

A. Required elements 

The FREEFORM REPORT LIMES field must contain the line numbers of 
the planning items, reflected as integers, and separated by a comma. 

B. Optional elements 

If the FREEFORM REPORT LINES field is not adequate to contain all of 
the line numbers, the character "C" may be used to continue the report data 
to column 25 of the next line of the SUMMARY REPORT format. 

Two line numbers may be separated by a hyphen to indicate 
that all lines between and including the lines specified are to be printed 
in the report. 

In generating sxararaary reports the planner also has the option to 
introduce one or more line spaces between planning items included in the 
report. To exercise this option a line number is specified in the report 
which was not previously assigned to any planning item in the model. The 
"spacing" line number is listed each time the printer is to skip a line 
in the summary report. There is no limit to the number of times that the 
same line may be used so that only one line of the model need be reserved 
as the "spacing" line. 

3-30 



The character *'S" is reserved. It indicates that the number im- 
mediately following specifies the scaling factor used on the values printed 
in the report. If this option is desired, the "S" must be the first entry 
in the FREEFQRM REPORT LINES field, with the meaning of the control number 
as follows: 

50 - Prints real numbers with two decimal places; 

51 - Prints integers rounded; 

SIO - Divides each value by 10, rounds the result, and prints 

integers; 

SlOO - Divides each value by 100, rounds the results, and prints 

integers; 

SIOOO - Divides each value by 1000, roiinds the result, and prints 

integers . 
> 

The default option, i.e., no use of the "S" character, generates 
numbers with two decimal place accuracy if all values of a planning item are 
less than 1,000,000. If any value exceeds 1,000,000 the planning item values 
will be integer. 

The planning item line numbers may be preceded by the character 

fly 11 

Li • 

Examples: 



a. A suramaiy report entitled "Basic Organization" to consist of lines 
10, 32, and 89 through 94 with the values in these planning items to be 
expressed in hundreds. 

Wt^ORT TiTtt FRteFORM Rt^OUT LINES 



Basic ciR&Ma3ttmoi\f 













b. The same report as described in Example a, above, but with a blank 
line appearing between lines 10 and 32 and between 32 and 89 (line 9 having 
been previously reserved as the "blank" line). 





rRCKFQNM NEPORT LINES 






• : 





ERIC 
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CHAPTER 5 



SYSTEM OUTPUTS 



The PLMTRAN II system outputs are generated on the printer and 
card punch. The punched cards are generated only vhen the punch "PUNC" 
instruction is used. These cards, vhich contain planning item values in 
the format of the "DATA" method of model specification, can be used to 
interrelate or interface, between separate base models. 

All other system output is printed. The first system output is 
an "Analysis of Matrix." The heading for this output is as follows: 

Organization Analysis of Matrix Date 

Model Description for a 

Run Number 6 (l2) period forecast Base year 

The heading information is developed from the data in the identification 
input format. The next heading contains, LINE, DESCRIPTION, BASE, and 
METHOD OF COMPUTATION. These terms are above columns vhich explain the 
model specification inputs, i.e., the line number, planning item descrip- 
tion, base level, and freeform method of computation. These model speci- 
fication data inputs are reproduced exactly ap they are specified by the 
planner. 

The purpose of the "Analysis of Matrix" is to provide the planner 
vith a listing of the model which he has specified. . The report has several 
uses. First, it provides a means to insure that the model vas keypunched 
exactly as specified by the planner. Second, it enables the planner to 
review the projection methods and interrelationships in the event that 
the model results are in error. Finally, it provides the planner with 
the complete documentation of the planning line base level values and 
assumptions incorporated into the model. This permits the logical expla- 
nation of the rationale of a given model, item by item if necessary, 
which is often important when communicating model results. 

The next system output describes the content of the summary re- 
port input. First is printed the term: THE FOLLOWING REPORTS ARE RE- 
QUESTED. This term is followed by a report title, and the freeform re- 
port lines for each summary report specified in the summary report input 
format . 



The next system output consists of diagnostics or error messages 
if they were generated in the first three system programs- A complete 
description of these messages and their format is given in Chapter 5. 

The next system output will he any computer printed plots devel- 
oped from use of the "PLOT" instruction. These plots may be of either six 
or 12 periods, with the time ^period values or terms printed on the left- 
hand margin of the page. The zero point for time is located in the upper 
left side of the page. Up to four planning item line values may be printed, 
using the characters x-, +, X, and 0. These characters are associated with 
the different planning items as specified in the model. A legend is pre- 
sented in the lower left section of the plot output. 

The next system outputs are the summary reports. These reports 
are the result of the planner's specifications in the identification and 
report input formats. It is a good practice to initially have one report 
which contains each planning item line* This report is useful in reviewing 
the model and making modifications to, or correcting, individual planning 
item values. Once the mqdel has been reviewed, proofed and debugged, and 
the planner is assured that it correctly and accurately depicts the desired 
relationship between planning elements, the report containing all planning 
item lines can be deleted and the summary reports which directly address 
the planning issue retained. 

The final system output consists of the diagnostics and error 
messages from the fourth system program. 



CHAPTER 6 



DIAGNOSTIC MESSAGES 



This chapter presents a "brief explanation of the diagnostic 
messages generated by the PLANTHWI II system; Errors are detected and 
corresponding diagnostic messages printed in each of the four major program 
modules in the PLAWTRAN II system. The four programs and their "basic func- 
tion are as follows: 

. PLANTRAN--This COBOL program decodes the model input and 
converts the input data from a free form to a fixed format. 

. TEEE— This FORTRAN program develops a ''tree" structure of the • 
model and each line item can "be computed in one pass. In addition, it 
checks the logic of thQ model for errors such as missing lines and loops. 

. HELP— This FORTRAN program performs the model computations- 

*. REPORT--This FORTRAN program prints the reports which are 

requested < 

The error messages and appropriate explanations are presented 

"below. 



I. System Program PLANTRAN 

A. You Have Exceeded 15 Line Numbers 

This message occurs in use of the summation (SUM). of punch method 
(PUNC). It is generated if there are more than 15 line numbers or more 
than 14 commas specified. The line numbers beyond the 15th are dropped 
and the system will continue. 

B. You -Have Exceeded 12 Items of Data 

This message occurs in use of the DATA method. It is generated 
if there are more than 12 values or more than 11 commas specified. The 
period values beyond the 12th are dropped^ and the system will continue. 
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C. There Is a Code Error in the Data Card Line Item XXXX^ 



This message occurs if the first four positions of tlje FREIEPORM 
l^ETHOD OF COMPUTATION field contain a term other than one of the following: 



PEEC 


SUM 


ACCU . . . S 


PLOT 


PCKT 


EQUA 


ACCS 


EETU 


PCT 




ACCU . . . P 


EOI 


CONS 


■SHIP 


ACCP 


HEAD 


INCR 


ma 


FILL 




DECK 


MAX 


PEOJ 




C50AL 


MINI 


PUNC 




data' 


MIN 


AVER 





The planning item is assumed to be a heading (HEAD). The system will 
continue . 

D- When Renumbering Punched Lines, Only 7 Lines May Be Used 

This message occurs in use of the punch (PUNC) method with the 
"as" option^ and indicates that the maximum of seven planning item line 
numbers, being renumbered has been exceeded. Any line numbers after the 
seventh before the "AS" are dropped^ and the scan continues. If more than 
the maximum of 15 line mjimbers are specified^ the diagnostic I-A v/ill 
be sho'i^- 



II. System Program TREE II 

A. Line Number XXXX Is Too High And Will Be Dropped. The Maximum 
Value for Line Numbers Is XXXX 

This message occurs -when a specified line number is larger than 
the number of lines the system can accommodate. For example, if the system 
is generated for 3^000 lines, the line number must be an integer "between 
1 and 3, 000. inclusive. 

Planning item lines vhich violate this restriction are dropped, 
that is, they are not included in solving the planning matrix. This error . 
•will not terminate the system, but it may lead to unresolved lines "which 



^ The line niimber of the planning item "with the incorrect term >rill appear 
where the XXXX is . shown". * 
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is cause for the termination of the system .r\in . This message occupies a 
single Printline and it may be intermixed vith error message II- E* Error 
messages IJ-A and II-B will appear in sequence immediately following the 
"Analysis of Matrix" report generated by the PLAMTRAN program. 

B. Duplicate Line Number XXXX in New Line Information. First 
Reference Retained, ' Duplicate Dropped 

This message occurs when a duplicate line number is encountered. 
Every line number used in a given model must "be unique . 

The planning item lines which violate this^ i.e.^ the duplicates^ 
are dropped^ and the first line number with that line number value is re- 
tained. This restriction does not apply to replacement cards properly 
entered to update a preceding model- -any line in the preceding model may 
be replaced. However^ "vdthin the replacement cards ^ as mthin the original 
model, every line number must be unique. 

This error will not terminate the system^ but it may lead to un-* 
resolved lines which cause termination of the system run. This message 
occupies a single Printline. It may be intermixed with error 
message II- A. 

C The Following Lines Cannot be Resolved 

LINE REQUIRES THESE UNRESOLVED LINES (A NEGATIVE LINE NUMBER ^ 

MEANS THAT TtlE REQUIRED 
LINE DOES mil EXIST) 

XXXX 
XXXX 
XXXX 

XXXX ^ . ■ 

This message contains a list of all the lines which could not be 
resolved in the analysis of "line dependencies within the model an'd indicates' 
any other unresolved lines upon which the given line depends. A line is 
"unresolved" if (a) it depends on one or more nonexistent lines; (b) it. 
depends on one or more unresolved lines; or (c) it depends, on one or more 
other lines which^ through some chain of dependencies^ depend on the given 
line (a logical loop). 

The existence of unresolved lines in a model mil terminate the 
system. Programs which follow will not be executed- Instead/ the system 
will re-enter the first program (PLANTRAN) looking for an update to the. 



XXXX 
XXXX 
XXXX 

XXXX 



t 



current model or for a nev model. This message will appear, if required, 
following any occurrences of error messages I-A and II-Fv The message is 
printed at the top of a new page. 

D. ^ ^ ^ Summary Report -x- -x- -x- -x- Requires These Unresolved Lines > 

(a Negative Line Number Means That the Required Line Does Not 

Exist) . 

i 

This message occurs if any summary report input specifies invalid, 
missing or unresolved lines. The message is followed by a list of the 
summary report titles and the corresponding invalid references. This 
message will appear, if required, following any occurrences of error message 
II-C. Specification of missing lines is not a fatal error, although such 
lines, of course, will not be printed. The message is printed at the top 
of a new page. 

E. Diagnostics From Subroutine TREE 

XXXX TOTAL LINES READ 

XXXX LINES DROPPED FOR INVALID LINE NIMBER 

XXXX . LINES DROPPED FOR DUPLICATE LINE NUMBER 
XXXX TOTAL LINES ACCEPTED 
XXXX TOTAL LINES RESOLVED 
. XXXX LINES NOT RESOLVABLE AFTER XXXX PASSES. 

This message occurs if any errors of types TI-A, II-B, II-C are 
encountered. 

The meanings of the message are self-explanatory. The message 
is printed at the top of the print page. 



III. System Program HELP 

A.. Line XXXX Cannot Be Calculated Because the Power Operation 
. Involves Negative Numbers 



This message occurs in, the user supplied equation or function 
(EQTN). It results from an attempt to use a negative exponent. If this 
condition is encountered the calculation of the line is terminated, the 
line will have values of zero in the planning periods and the system 
will continue. 



B. Line XXXX Has a Negative Beginning Year. This Is Not Allowed 

This message occurs in using the "Beginning In" option for change 
"by a percentage (PERC, PCNT^ PCT); change by an increment (DECR, INCE); and 
change to achieve a goal (GOAL), The "Beginning In" period cannot be in 
the past, only in, the present or the future. The calculation of the line 
will terminate, the line will have values of zero in the planning periods, 
and the system vill continue. 

C. Line XXXX Has No Goal Period. A Goal of 1 Year Is Assumed to 

Prevent Division by Zero 

This message occurs in use of the change to achieve a goal (GOAL) 
instruction. When no goal period has been specified^ the goal period is 
"set to a value of one, the goal value is inserted in all the planning periods, 
and the system continues. 

D. Line XXXX Has a Goal Year Prior to a Beginning Year. This Is 

Mot Possible 

This message occurs in use of the change to achieve a goal (GOAL) 
instruction, -when the beginning period is greater than the period in ^ich 
the goal is to be achieved. The calculation of the line is tenninated, 
the line mil have values of zero in the planning periods, and the system . 
vill continue. 



E. There Is a One Item Comparison Error in Line Item Number XXXX 

This message occurs in use of the maximum or minimum of other 
planning items, (MAXI^ MINI, MAX^ MIN) instruction, -when a single planning 
item or constant has been specified. There must be at least two values in 
order to compare, i.e., either tvo line numbers or a line and a constant 
value. The calculation of the line is terminated. . The line "'all have values 
of zero in the planning periods and the system will continue. 

I 

IV. System Erogram REPORT 

TEE FOLLOWING NONEXISTENT LINES WERE REQUESTED IN THE SUMMARY REPORT 

This message occurs when the planner has specified nonexistent 
line numbers in the summary report data input format- The nonexistent 
line numbers are deleted, the summary report is generated as specified, 
and the system continues. 
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CHAPTER 7 



GMEMTING ALTERNATIVE FLMS: USE OF THE SYSTEM DRIVER 



Simulation provides planners a meanr. of experimenting" vith various 
alternatives. PLANTRAN II uses a simple and effective feature to enhance 
this experimental capability. 

The feature- -called a "systems driver" --drives or steps the 
system through successive, planner-specified alternatives. This technique 
•works as follovs: the basic^ or first, model is entered and executed; the 
projections are generated for the planning matrix as indicated by the model 
specification input; the matrix is balanced; and reports are printed as . 
called out by use of the summary report input. 

Next, the system reads inputs representing different or alterna- 
tive projections associated with ong or more planning items. These changes 
cause the entire planning matrix to be recomputed .to bring the matrix into 
a nev" balance and the reports reflecting the different, or alternative, 
plan are generated. 

The system handles each set of changes sequentir.lly and computes, 
or balances, the associated plan. Since there is no limit to the number 
of changes that may be initiated, the planner may design an experiment to 
sveep through many alternatives. These alternatives permit the examination 
of a large number of solutions to a given problem. The^ speed and ease of 
the technique enable the planner to learn more about the relationships be- 
t-ween various planning items, experiment vith those items and compare the 
results -with known, objectives . 

Use of the system driver in the PLANTRAIiF II system is quite simple. 
A card -with the value 9999 in columns 1-4 is inserted following the last 
summary report input card of the basic model. This ^'9999" card may be 
followed by an optional identification input card, which has an "R" in the 
R field, columns 65-66. This indicates to the system that the input which 
follows involves replacement data to the basic ^ or first model. 

If the optional columnar headings are provided, the identification 
input card must contain an "H" in the H field, columns 63 -64. If that "H" 
is specified, the card following the identification input card must be in 
the column heading input fclrmat. 
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The next cards are the changes to the basic model expressed in 
the model specification input format. Note that these cards replace the 
model specification input in the basic model. If line numbers of the 
replacement planning items are not the same as those beinn; replaced in 
the basic model, the replacement items are added to the model. 



There is no limit to the number of replacement planning item 
lines "Which can be entered at one time. 

Another "9999" card (columns 1-4) follows the last replacement 
card in the model specification input. That "9999" card may be followed 
by another optional identification input, optional columnar headings and 
replacement model specification cards. The summary report input for alter- 
native iterations is the same as in the basic model . 

In using the systems driver, it is important to note several 
things. The sequence of replacement data must be explicitly followed: 

9999 

Identification input (optional) 
Columnar heading input (optional) 

Model specification input \ 
9999 

Identification input (optional) 
Columnar heading input (optional) 
Model specification input 
9999 

Second, it must be kept in mind that from iteration to iteration 
the basic plan reflects the original plan values rather than the latest 
changes, i.e., the changes from iteration to iteration are not cumulative. 
Third, note that the summary reports generated by replacement data are 
the same as those specified for the basic model. 

Finally, the sequence of computer printout must be understood. 
The "Analysis or Matrix" and suiranary reports will appear for the basic 
model just as if no replacement ' data TOre involved. The last summary report 
will be followed by a section ,i3itle "LINE CHANGES TO BE MADE TO ORIGINAL 
MODEL." Following this, will be a heading stating "LINE," "DESCRIPTION," 
"base" and "METHODS OF CONEPUTATION . " Immediately under, and associated 
with these headings, will be the line number, planning item description, 
base value, and method of computation of the input in the replacement data. 
These data will be printed exactly as specified by the planner. 
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Next will be any diagnostic or error messages vhich may have 
been generated, follov/ed by any specified plot output. The last output 
consists of the summary reports as specified in the original bar.ic model. 

The above sequence vill be followed for each set of replacement 
data. If the optional identification input and columnar heading input 
cards reflect changes from the original model, they will be incorjjorated 
in the summary reports for the iteration. 
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CHAPTER 6 



DATA ORGANIZATION 



This section describes the input sequences for setting up the data 
decl-cs to accomplish common types of planning sy'^tem runs. A review of these 
examples will provide the planner with samples which he may use, or modify^^ 
to structure a system run for a specific planning need. 

Example 1: Base Model Run 

A. Identification Input 

B. Columnar Headings Input-Optional 

If this card is used, it must be preceded by an identification 
card with an "H" in Columns 63 or 64, indicating that headings 
are to be provided, 

C. Model Specification Input 

D. "9999" in Columns 1-5 

E. Summary Reports Input 

F. "9999" in Columns 1-4 
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Example 2: Base Model with One Replacement Iteration 



I 



t 



ERIC 



A, Identification Input 

Columnar Heading Input-Optional (See Note l) 
Model Specification Input 

D. "9999" in Columns 1-4 

E. Summary Report Input 

F. "9999" in Columns 1-4 

G. Identification Input -Optional (See Note 2) 

H. Columnar Heading Input -Optional (See Note l) 



I. Model Specification Input 

The replacement planning item data 




O 



Note 1 - If this card is used, it must be preceded by an identification 
' input card with an "H" in Columns 63 or 64, indicating that 

headings are to be provided. 
Note 2 - If this card is used, it must have an "r" in Columns 65 or 66, 

indicating that the following data are replacement data. 
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Example 3: Base Model with Two Replacement Iterations 



A. Identification Input 

B. Columnar Heading Input-Optional (See Note l) 
C* Model Specification Input 

"9©©^" in Columns 1-4 

E. Summary Report Input 

F. "9999" in Columns 1-4 

G* Identification Input-Optional (See Note 2) 

H. Columnar heading Input-Optional (See Note l) 

!• Model SpeAfication Input 

J. "9999" in Columns 1-4 

Identification Input -Optional (See Note 2) 

L. Columnar Heading In put -Optional (See Note l) 

M. Model Specification Input 

N. "9999" in Columns 1-4. 




Replacement Cards 
for 2nd Iteration 



/^Modcl Spocirtcolion Input 


/ Cillumnor Heading Input 






/ Idi'fitif icotior^ Inpul 








0 

c 










1 


g 











placement Cards 
for lit IteraMon 



Note 1 



Note 2 



If this card is used, it must be preceded by an identification input 
card with an "h" in Colutms 63 or 64, indicating that headings are 
to be provided. 

If this card is used, it must have an 

dicating that the following data are replacement data- 



"r" in Columns 65 or 66, in- 



ERLC 
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Example 4: Two Independent Base Models 

A. Identification Input 

B. Columnar Heading Input-Optional (See Note l) 

C. Model Specification Input 

D. "9999" in Columns 1-4 

E. Summary Report Input 

■ F. "9999" in Columns 1-4 
G. Identification Input (See Note 2) 

Columnar Heading Input -Optional (See Note l) 
I. Model Specification Input 
J. "9999" in Columns 1-4 

Summary Report Input 
l; "9999" in Columns 1-4 



1st Model 



2nd Model 




Note 1 



Note 2 - 



If this card is used, it must be preceded by an identification input 
card with an "h" in Columns 63 or 64, indicating that headings are 
to be provided. 

This Card must not have an "r" in Columns 65 or 66. 



ERIC 
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Example 5: Two Base Models, Each with One Replacement Iteration 



A, Identification Input 

B, Columnar Heading Input -Optional (See Note l) 
Model Specification Input 

D. "9999" in Columns 1-4 

E . Summary Report Input 

F. "9999" in Columns 1-4 

G. Identification Input -Optional (See Note 2) 

H. Columnar Heading Input -Optional (See Note 2) 

I. Model Specification Input 
J. "9999" in Columns 1-4 

K. Identification Input (See Note 3) 

Columnar Heading Input -Optional (See Note 2) 

M, Model Specification Input 

N. "9999" in Columns 1-4 

0. Summary Report Input 

P. "9999" in Columns .1-4 

Q. Identification Input-Optional (See Note 2) 

R. Columnar Heading Input -Optional (See Note l) 

S. Model Specification Input 

T. "9999" in Columns 1-4 



ERIC 



Note 1 - If this card is used, it must be preceded by an identification 
input card vith an "h" in Columns 63 or 64, indicating that 
headings are tw be provided. 

Note 2 - If this card is used, it must have an "R" in Columns 65 or 66, 
indicating that the following data are replacement data. 

Note 3 - This card must not have an "R" in Columns 65 or 66. 

8-5 



CHAPTER 9 



SAMPLE UNIVERSITY MODEL 



This chapter provides an example of the use of PLANTRAN II in 
meeting the planning needs of an institution. The brief description of 
"Sample University" is followed by the PLANTRAN Model Specifications. The 
Summary Reports and the Analysis of Matrix follow. 



I. History 

Sample University was founded in 1864 as a church-related college. 
In 1934 it officially disassociated itself from the church and became non- 
sectarian. It began offering graduate programs after World War II and had 
developed a few Ph.D. programs when it entered the state university system 
in 1959. Its enrollment has more than doubled in the last 10 years. In 
general, the last decade has been one of expansion and optimism for Sample. 



II, Enrollment 

Sample's current undergraduate enrollment is 12,622 of whom 
llj581 are in-state students. Sample's planners know that the 18-year-old 
in-state cohort will begin to decline in 1978 after having leveled off in 
1975. Currently 51 percent of the cohort attend post-secondary institutions. 
Sample's share of this market is presently 9.5 percent. The university 
feels that the attendance rate of 51 percent will stay constant for two 
years and then increase about 0.5 per year. Sample's share of these students 
can be projected linearly from past data. Out-of-state undergraduate stu- 
dents are limited to 11 percent of the in-state undergraduates. 

Total graduate enrollment stands at 2,428 of whom 1,928 are 
residents of the state. Due to facility constraints and a leveling off 
of federal funding for graduate programs, the university feels that in-state 
graduate enrollment will stay constant for the next 3 years after which 
it will resume its 3 percent annual increase. Out-of-state graduate enroll- 
ment will decline to 300 by 1975. 



I 



III. Fees 

In-state undergraduates are paying fees of $405 per year. Although 
Sample has delayed increasing its fees to students for the last 5 years, 
this is no longer possible. In fact, the best estimate is that fees 
for resident undergraduates vill have to increase about $20 per year. Non- 
resident undergraduates nov pay $1,300 a year. This vill increase 6 percent 
annually. Resident graduate students pay more than the undergraduates; this 
will 'increase to $600 by the fourth year beginning in 1973; current fees 
are $500. Out-of-state graduate students pay $1,500 a year. This will 
increase to $1,800 in 2 years. 

IV* Faculty 

The student -faculty ratio at Sample has not changed appreciably 
since the late forties. The undergraduate student -faculty ratio has been 
18:1; the graduate ratio hovers around 6:1. Because of the "traditional" 
character' of these ratios, the university's planners must assume that they 
will not change in the future. Thus they are planning with constant student - 
faculty ratios at both the undergraduate and graduate level. 

Sample's faculty is divided into an undergraduate faculty numbering 
700 and a graduate one of 400. The average undergraduate faculty salary is 
$12,389. This will be increased at 6 percent per year. The average graduate 
salary is $16,780 which will be increased at 8 percent per year. 

V. Revenue 

The major income variable is the amount of support received from 
the state, government . This currently stands at $1,605 per resident student 
(graduate and undergraduate). Since there are signs that the state is 
reaching a plateau in its level of support, the Sample planners are assuming 
that state appropriations will remain constant for 4 years and then can 
be increased $100 per student each year. 

The following table summarizes the other income items and their 
expected changes through time: 
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V 



I 

Income Item 

Endovment Income 

Gifts Applied to 
Current Operations 

Sponsored Research 



Recovery of Indirect Costs 



Current Levels 
$ 50,000 ; 
6,500,000 

800,900 



309,000 



Changes 

Increase 1 percent per year 

Increase 5 percent beginning 
in third period 

Decrease to $500,000 by third 
period 

38 percent of the sponsored 
research 



VI. Expense 

On the expense side, the major costs are instructional salaries. 
These projections will be developed on the basis of the staffing and salary 
factors presented earlier. 

^Salaries for support staff vill be equal to 30 percent of the 
undergraduate faculty salaries and 60 percent of the graduate faculty 
salaries. The nonsalary support costs are presently at $900,000. These 
vil], stay constant until the fourth year vhen they vill begin to increase 
6 percent per year. 

Expenditures for extension and public service are now $300,000 
and they will increase $50,000 per year. Student services are funded at a 
level equal to $300 per undergraduate student plus $100 per graduate student. 

Student aid expenditures are based on the assumption that the 
total undergraduate financial aid will be equal to 10 percent of the resident 
undergraduates receiving full fee scholarships. Graduate financial assistance 
will be equal to 30 percent of the resident graduate students receiving 
complete fee remission. 

Library expenditures will be equal to 10 percent of the sum of 
instruction/departmental research expenditures, sponsored research, and 
extension public service expenditures. 

The following table summarizes the other expense items and their 
expected changes through time: 



9-3 



Expense Item 



Current Level 



Changes 



Operation and Maintenance 
General Administration 
General Institutional 
Auxiliary Enterprises 



$ 2,300,000 
1,900,000 
100,000 



2,195,000 



Increase 6 percent 
Increase $55,000 per year 
No change 

90 percent of auxiliary 
enterprise income 



VII. - Reports 

The Sample University planners have taken all of the factors 
discussed above and put them together in a logical fashion. The PLANTRAN 
Model Specifications used to do this begin on page 8- 6 • The Analysis of 
Matrix on page 8-12 allows the planners to review all the Model Specifications 
in an orderly manner. The planners developed a number of Summary Reports 
which begin on page 8-18. 

Matrix analysis ; This report includes all the planning item lines 
used in the model. It is useful to the planner in debugging the model 
and insures that he will have output for every line. 

Enrollment ; This report presents all the projections for the 
number of students who will seek educational services from Sample University. 
A number of different categories are used to display the information in 
ways meaningful to the planners and decision makers. Notice that the report 
is scaled in units. 

Income-expense variables : This report presents all the "non- 
financial" items which determine the major portior of income and expense. 
These include the fee structure, the student -faculty ratios, the number of 
faculty, and faculty salary levels. Since these are the major assumptions 
underlying the budget model, it is important for decision makers to be aware 
of them. These variables are the ones on which administrative options can 
be exercised. 

Current fund account ; This is the revenue and income operating 
statement for Sample University under the assumptions of the model. It is 
in the standard format recommended in College and University Business 
Administration, 
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Key indicators : This report presents elements of the current 
fund report, enrollment report, and the income -expense variables report. 
These are the "highlights" of the simulation. Administrators can find the 
important indicators in one short report » 

Analysis ; This report analyses selected income and expense items 
as percentages of other items. For example, line 78 tells the planners 
what percentage of total income is accounted for by student fee income. 

Surplus / deficit ; This short report deals with the surplus or 
deficit of the current fund account. It is a specialized report which' 
presents the level of the surplus/deficit and four statistics developed 
from it. 

Educational and general income : This is another special report 
dealing only with the educational and general income. Notice that it is 
scaled in thousands . ' 

Plot: The reports include two plots. One shows the relationship 
between current expense and current income. The other shows the growth 
patterns for the major elements of current fund expense. 



VIII. Analyses 

The most obvious analysis is to compare the total current income 
with the total current expense. In the first projected period this results 
in a surplus of $1,061,744. To learn the long-range effects of the pro- 
jections and assumptions detailed above, the figures for operating surplus/ 
deficit are accumulated throughout the 12 -year period for a total of 
(negative) $14,627,168. 

Another type of analysis is to indicate the percent of the total 
budget represented by the various components. According to the above pro- 
jections, instruction and departmental research can be expected to climb 
from 60.98 percent in 1972 to an eventual 74.4 percent of the total budget 
in 1983.. 

State ' appropriations will pay 53.29 percent of total current income 
in 1972. The percentage will , increase to 60.72 in 1983. Income 
from student fees will increase to 22.32 percent of the total current income. 
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APPENDIX A; MATHEMATICAL DESCRIPTIONS OF LANGUAGE ELEMENTS 



I. INSTRUCTION NOTATION 

The following notation has been adopted to provide a succinct and 
compact definition of PLANTEIAN II instruction SYNTAX: 

• Key characters are capitalized and underlined; these char- 
acters are mandatory, 

o Literal characters shown in lower case and not underlined may 
be added for clarity — they are not meindatory. 

o Brackets [ ] are used to indicate required elements of the 
instruction. 

Example ; | ^GOAL j of [v] in ^.nj years 

The operation code, GOAL; the goal value, v ; and goal 
period, n — are required elements of the instruction. 

. Braces [ J signify that one of two or more alternatives is a 
required element. 

Example ! 



To indicate a compouiid growth or decay, the operation 
code PCT, PCNT, or PERC(ent) may be used, 

. Parenthesis ( ) indicate an optional element. 

Example ; ^INCRj ease lOO^ear (B eginning in 3^rd year) 

"Beginning in 3rd year" is optional. Default is to 
begin in 1st year. 

o Mathematical notation. 

•'^i'k ^"■th period value of a given (i-th) variable 
(planning item) 

Aj_,Q = base or cirrrent value of a given (i-th) variable 



PCT 
PCNT 
PERC 



increase of 



ent 



[p] 



per year 



ERIC 



A-l 



II o INSTRUCTION SET 



A. Percent 



year - 



PCT 




I 


ncrease 


PCME 




D 


ecrease of 


PERC 


< 

ent 


+ 













p I month 
]z(j per year 

reriod 



[b] 



eginning 



monthX 
in ^n] th period! 

year / 



ecc . 



P = n\mieric specification of compound percentage change 
^ = blank assumed to be zero percent 
n = integer where 1< n ll2 

if the ^'Beginning in..." option is not used^ period 1 is assumed 
Example : 

Percentage increase of 7.5 percent per year beginning in third 



40 


FKEEFORM METHOD Of COMPUTATION — 

hficiEiur mens AS E. is p:t u^/h/ iko fetaoo 




PCAn\ :wcfi 1, 5 *>(> B£Gin/ 3rd PfitiCiD 




PCT \ 1.5% f, 3 




Pcr\l>S35 



Mathematical Definition 



Ai,k = A.^^ (1 H- p/100) 



k+l-n 



= A 

i,o 

B. Increase/Decrease 



for k > n 



for k < n 



■FiNCR] ement 
LdECRJ ease 



month / month 

per period ([^1 eginning in period 

. year , \ year • 

etc . etc . 



A = periodic incremental change 

^ = blank; assumed to be zero increase/decrease 

n = integer J ll n 1 12 

A-2 



[■>] 



Example ; 

Incremental decrease of 72.37 per year "beginning in fourth year. 



BASE LEVtL 



fREEfORM METHOD Of COMPUrAriON 





40 




^OOO 




2000. 









Mathematical. Definition 



= ^ + (k+l-n) A 



C. Goal 



if k < n 
if k > n 



r r 1 p , months month p 

[GoalJ of [vjin I ml periods ( Ib eginning in .period In 

years ^ y ear 



years 
etc. 



etc. 



V = goal value 



m = 



n = 



integer l5 ml 12 specifying the period in which goal is 
to be achieved 

integer l^n!^m-l specifying period in which change is to 
begin 



Example ; 

Change to a goal of 2100 in 8 years beginning in fourth year. 



BASE LEVEL 



FWEEfOWM HETHDO DF COHPUTATlON 



Mathematical Definition 



A. , = A. 
i;k 1,0 



for k < n 
for k > m 



= (v - Ah ^) (k+l-n)+A. for n <k < 
(m+l-n) 



m 



Data 



DATA 



^^1, ^2, ^12) 



~ numeric between - 999 999 999 999. 9999 



blanks assumed to "be zero 



Example: 



BASE LEVEL 



FUEEFOHM METHOD Or COMPUTATION 



'o^ mm j/s-o, /2.^o. /25tP. ;3gg>./3fQ,/<£r?,c 



i^iroj /ss-o'^ fss-o) jLsOj JL^Cj nso 



iVIathematical Definition 



A. T = V or 

A. T = zero if kth position blank 



E- Sum 



of lines [x^] (.i^.-./is) 



j6. - line number 
1 



Example: 



BASE LEVEL. 



FHECFORM METHOD OF COMPUTATION 



<y?j g^j yo3 



Mathematical Definition 



A..=A +A +...+A- 

l,k ^2,k 15,k 



where 



is i-th designated line number 



F. Shift 



SHIF t (^c) [L]ine[;e] 



orward months \ 

[p] periods j 
a ckva rd y ea r s J 

etc . / 



c = constant multiplier, if blank, 1 is assiimed 
I = line number to be shifted 

p = number of periods — extent of shift, 13>p>o 

default option is to shift forward (right) one period 
Example:- 



FREEFORK METHOD OF COMPUTATION 



^p\t nS" Lil tACK U PERIOOS 



Mathematical Definition 



A. , = c A if shift forward 

= c A. , ,^ if shift backward 



= c 



A . , -, if default option 



G. Equation 



BQTW 
EQUA 



tion 
Is 




C. = numeric constant 
1 



L. = line number 



Example ; 





'REEFORM METHOD OF COMPtJTATtON 


(to 




ECTAil ^<.^:t. LIVE LS" UrOB 10-4 



A- 5 



Mathematical Definition 



A. , = f 



fc k ... C \ 



where the function^ f ^ is an analytical function of up to 4 
variables (lines) and up to 4 constants. 

li. Maximum/Minirfium 



^ tng n 



L. = line number 
J 

c = numeric^ representing a constant value 



MAXI 


mum of 








MAX 






MUTI 






_MIW _ 













Example ; 



FWeCFOWM METHOD OF COMPUTATION 





WijL\Tn\/fn OP L^o(», -I<?.^.3 


«o 







Mathem.atical Definition 



I. Fill 



MAXIMUMS (A. , A 



INFILL . line [i] 



i = line 


number 




Example : 


FKEEFORM METHOD OF COMPUTATION 




% 40 


41 44|46 


«o 


V" 


P/Ll| i.73 




PIUi 73 
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Mathematical Definition 



ERIC 



m 




This instruction utilizes a technique of "semi- averaging. " 

"Semi-averaging" consists of a linear fit to^ existing data 
points by averaging the first half of the data points for y-j_ , the first 
half of the indices for x-]_- -proceeding similarly for the latter half of 
the points for and X2 — the equation of a line is determined. This 

equation is used to "FILL" gaps or missing data points. Only missing 
data points are "filled. " , • 



J. Project 

[pROjJ ect line [sl 
^ = line -number 

Example : ' 







AO 






Matheniatical Definition 



See mathematical definition of FILL, Using the same "semi- 
averaging" method, the equation for a linear function is computed and 
PROJECTED, extended or extrapolated through the next time periods 13 
through 24. Thus, 



Ai,k = (m) (k+12) -f b 



A-7 



K. Acciimulated Sum or Product 



ACCU 
ACCS 
ACCP 



mulated f S 1 um 



r S lum 

1 P J roduct of line [i] 



a = line number 



Example : 



f WEEFOWM METHOD OF COMMUTATION 



41 AaWz 



t)CmihULt\lE TUB PRDDIJCr OF UlUB *?7 



Ifethematical Definition 



Ai^k =1 A if SUM; 



k 

IT 



A. , =11 A„ , if PROrUCT 



L. Punch 



[pUTJCjh lines [^J Xg, X3, — . ([a ] S [i-^^, i^y. — 



line number 



n = m if AS option used 



Example : 



f WEEFOWM METHOD OF COMPUTATION 





41 44 


4ft . , «0 

W LWB'd ior^ III, Hh IS J. , /g-O AS c 






^a/^BS 31, ^Uj IL, 71 












L3h LHU^ i/i,. L9. Lit 
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M. Average 

[aver] age of line [ j j 



j = line number 
Example; 



FHEEFOWM METHOD OF COMMUTATION 



41 44(45 



Mathematical Definition 



k 

\k=- I A. 



N. Plot. 



[plot] lines [,J (T Xg, — 



i, = line nianber 
1 



Example ; 



rWEEFOBM METHOO OF C0WPUT*T10N 



41 44t4S 



i^ of, L37j L4'3j Lfji; L^y S 



ERIC 
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0. Return on Investment 

month 

TROI \ year 

[RETUj rn on investment over [nj period, line [ ij beginning in 

etc. 

month 
year ■ [ 
period, 
etc. 

I = line number 

n = number of years in the time span of consideration 
m = beginning period 

Example ; 



FHEgrOWIl METHOD OF COM^UTATfON 
41 44145 



Mathematical Definition 



A =0 for i ?^ 1 and valid cash flow series 



A. , = 9999o99 if invalid cash flow series, i.e., there must be 
at least one negative and one positive value of C. . 

A^ ^ = I, compound interest rate which discounts cited net cash 
flow series to zero according to the expression: 

n-1 ^j+m ^ , 

r- — r = 0 where 

^ (1+I)J 



= net cash flow, period j 
m; n, I = as defined above 
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p. Heading 
I^HEADj ing 



Example ; 



LINE HO PLANNING ITEM 



BASE LEVEL 



FWEEFOWM METHOO OF COMPUTAT>ON 



41 AaT^S 



5 



I!K3 



Q. Summary Reports 

[^report title J (S-code) , ^i] (^'^2' 



3 



S-Code = scaling instruction for numeric values- 
SOO = 2 decimal places 

SI = integers ; rounded 
SIO = values x 10 
SlOO = values x 100 
SIOOO = values x 1^000 
SIOOOO = values x 10^000 
1^ = line number- 
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APPENDIX B; GLOSSARY OF WORDS AND TERiMINOLOGY 



Accumulative product 



Accnmulative sum 



Base level 
COBOL 

Constant value 



Data point 
Default option 



Planning item values are multiplied horizontally 
across the planning horizono Thus^ if annual 
values are: 1; 2, 3^ 4, 5/ 6; 7, 8; 9; 10; 11, 
12; the accumulative product is: 1, 3; 9, 36; 
180; 1260; 10080;; 90720; 907200; 9979200; 
119750400. This capability is useful in eval- 
uating growth rates expressed as compound per- 
centage increases. 

The horizontal summation of the planning item 
values are taken one by one in each period of 
the planning horizono ThuS; if annual values 
for a given planning item are: 1; 1; 1; 1; 1. 
1; 1; 1; 1; 1; 1; 1^ then the accumulatlve sum 

is: 1; 2; 3;. 4; 5; 6; 7; 8; 9; 10; 11; 12, 

The beginning or current level of a given plan- 
ning itemo The numeric value that is assigned 
to that item now. 

A high level programming language particularly 
suited for writing programs to process large 
files of data^ using a vocabulary of common 
English wordS; phrases and sentences. CQmmon 
Business Oriented Language, 

A value that remains fixed throughout the time 
span of the planning horizon. Constant values 
are often used as multiplying factors in equa- 
tions. Constant values may also be projected 
across the planning horizon as bounding valueS; 
for example o 

Individual values in a string of data. 

The operation performed by the system in lieu of 
planner specif ications « For example; if the T 
field of the Identification Input format is 
blank; the system generates a 12- column planning 
horizon. 



B-1 



Delimiter 



Exercising the model 



Field 



FORIRM 



Freefom method of 
computation 



Input 



Line number 



Linear regression 



. Logical loop 



ERIC 



To compensate for that lack of structure in the 
"Freeform" instructions ^ some character must be 
used to separate the several parts of the in- 
struction. For example^ the Data instruction 
requires that the individual data points be 
separated by commas. These commas serve to 
delimit the fields- -thus they are called 
delimiters. 

The processing of the model in computer runs- 
The examination of model results under various 
and varied alternative assumptions. 

A data processing term. A field is a c:olIection 
of one or more contiguous characters usually in 
a machine sensible form and considered as one 
data item. Example- -the Planning -Item field is 
the collection of alphabetic^ numeric^ and 
special characters (including blanks) between ' 
card columns 5 and 28 of an instruction, 

A coding system using mathematical notation for 
programming scientific problems to be solved by 
a computer, FORm ula TRAl slation. 

This portion of the model specification is called 
freefbrm because it accommodates a variety of 
ways to describe how the item is to be projected, 

Data^ information J and instructions put into a 
format assembled in an appropriate fashion to 
be applied to the computer for processing, 

A nonsymbolic number assigned to a planning item 
for ease in identification and internal m^^.nipula- 
tion. The line number concept is analogous to 
the budget line numbers. 

A statistical routine to determine the relation- 
ship between two variables. ''Linear" means that 
the relationship does not change through time or 
across groups of variables. 

A closed series of dependent relationships. There 
must also be at least one independent planning 
item in a series of relationships. 
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Model 



In the FTJUmAN II system, a collection of 
planning items, identified vith a verbal 
description as veil as a "unique line number and 
each vith an associated instruction for projec- 
tion of values through time. Tlie model is a 
vehicle or analytic tool that aids in the pre- 
diction of how an institution or organization 
vould react or perform under a given, hypothe- 
sized set of conditions. 



Output 



The product or result of a computer run usually 
in the form of a pre-designated report or 
machine- readable data. 



Planning horizon 
PLAMRM 



That period of time of interest to the planner. 

An acronym for PLMning TElAWslator. An English- 
like language in vhich a planner may instruct 
the computer to perform calculations in order to 
project values of a given planning item through 
time. 



Printer plot 



This is a system output vhich plots the period 
values of up to four planning items. This re- 
quires no special plotting equipment but uses 
the computer's printer. 



Printout 



The physical product of a computer run. 
tabulation. See Output above. 



Reserved character 



Within the rules of the PLAMRAW language, 
certain characters in the "freeform method of 
computation" have special meaning and cause the 
computer to perform special calculations. Since 
the 'Computer cannot perceive the context in 
vhich these characters are used, they are re- 
served and are not to be used except as defined 
in the rules of the language. See Chapter 3 
for a discussion of these rules. 



Right adjusted 



To place the rightmost character of a data item 
in the rightmost position in the field designated 
for that item. No space is left in that field 
folloving the information entered. 
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Self- scaling 



A feature of the PLOT instruction in vhich the 
vertical axis is to have a value other than 
:^ero • 



System driver 



The facility within the PLMTEIAU II system to 
automatically step through a series of pre- 
designated \iter8tions or runs examining several 
sets of hypotheses at one time. This capability 
permits the design of experiments to examine 
multiple alternatives simultaneouslyo 



Variable 



One planning item. Mathematically the planning 
items or variables are considered to be a matrix 
of row vectors that are either auto- generated or 
are functions of other row vectors. The descrip- 
tion of a planning item along with its 12 (or 6) 
projected values is considered to be one variable. 
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